@diousk/pi-subagents-fast 0.22.0 → 0.24.0

package/CHANGELOG.md

@@ -7,6 +7,16 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [0.24.0] - 2026-10-02
+
+### Added
+- **Routing runtime status in `/agents`.** Open Model routing → Runtime status to inspect effective configuration, credential presence, eligible profiles and the latest retained routing decisions, including fallback reasons and actual model/thinking. The refreshable, read-only view hides API keys and makes no classifier request.
+
+## [0.23.0] - 2026-10-02
+
+### Changed
+- **BREAKING: Jev model profiles require `thinkingLevel`.** Add `minimal`, `low`, `medium`, `high`, `xhigh` or `max` to every `jev.models` entry. Successful routing applies the model and thinking level together; shadow and fallback preserve the original pair. The routing menu requires a level, and invalid or missing levels disable the Jev block with a diagnostic.
+
 ## [0.22.0] - 2026-10-02
 
 > **Breaking: requires Pi 1.0.0 or newer.** Update Pi before using this version.

package/README.md

@@ -634,7 +634,9 @@ When background agents complete, they notify the main agent. The **join mode** c
 
 ## Model routing
 
-Open `/agents → Model routing` to choose a mode and configure a guideline path, models with descriptions, or a masked TypeSafe API key. The menu shows the active mode and source and saves project settings. For machine-wide defaults, edit `~/.pi/agent/subagents.json`; project overrides go in `.pi/subagents.json`. `PI_CODING_AGENT_DIR` changes the global directory along with Pi's other configuration.
+Open `/agents → Model routing` to choose a mode and configure a guideline path, models with descriptions and required thinking levels, or a masked TypeSafe API key. The menu shows the active mode and source and saves project settings. For machine-wide defaults, edit `~/.pi/agent/subagents.json`; project overrides go in `.pi/subagents.json`. `PI_CODING_AGENT_DIR` changes the global directory along with Pi's other configuration.
+
+Use `/agents → Model routing → Runtime status` to inspect the effective mode and its project/global source, routing priority and fallback, guideline path, configured model/thinking profiles, current candidate eligibility, classifier availability and credential presence. No API key is displayed and opening the page does not classify a task. Credential presence does not confirm that the service will accept it. The page also shows the latest ten retained agent decisions, including selected versus actual model/thinking, shadow suggestions, confidence, fallback/error reasons and classifier usage. This is an in-memory view, not a durable log: evicted records and previous sessions are not included. Press `r` to refresh, Up/Down to scroll and Esc to return.
 
 Set one top-level field to control routing; omitting it means `auto`:
 
@@ -660,7 +662,7 @@ The default priority is:
 | 3 | `jev` is configured | Jev chooses a model from your descriptions for a fresh delegated task |
 | 4 | None of the above | The existing model is used |
 
-**Custom agents:** keep using `~/.pi/agent/agents/<name>.md`, `.pi/agents/<name>.md` or `.agents/agents/<name>.md`. No routing setting is needed. Built-in and disabled agents do not activate priority 1. Agent-file model/thinking pins supply the default choice over `Agent` parameters; a confident Jev choice in `jev` mode can replace the model.
+**Custom agents:** keep using `~/.pi/agent/agents/<name>.md`, `.pi/agents/<name>.md` or `.agents/agents/<name>.md`. No routing setting is needed. Built-in and disabled agents do not activate priority 1. Agent-file model/thinking pins supply the default choice over `Agent` parameters; a confident Jev choice in `jev` mode can replace both model and thinking level.
 
 **Custom guideline:** write your routing rules in `~/.pi/agent/agents/custom-route.md`, then configure:
 
@@ -679,16 +681,16 @@ For example, the Markdown can say “Use anthropic/claude-haiku-4-5 for simple e
   "jev": {
     "TYPESAFE_API_KEY": "your-typesafe-key",
     "models": [
-      { "model": "anthropic/claude-haiku-4-5", "description": "Simple edits, lookup and concise summaries" },
-      { "model": "openai-codex/gpt-6.1-sol", "description": "Complex debugging, architecture and concurrency" }
+      { "model": "anthropic/claude-haiku-4-5", "description": "Simple edits, lookup and concise summaries", "thinkingLevel": "low" },
+      { "model": "openai-codex/gpt-6.1-sol", "description": "Complex debugging, architecture and concurrency", "thinkingLevel": "high" }
     ]
   }
 }
 ```
 
-`TYPESAFE_API_KEY` is optional when Pi already has TypeSafe credentials or the environment variable is set. A literal key must be a nonempty token without whitespace or control characters and applies only to that classifier request; it is saved in the settings file, masked in the menu and omitted from settings events, prompts and routing records. Without a literal key, Pi's native credential availability check runs before classification. Rejected credentials fall back without retrying. The extension does not change environment variables or register a routing provider. `models` accepts 1–254 unique entries with descriptions of 1–4000 characters. Jev entries use exact `provider/model-id` spelling; fuzzy names remain available for explicit `Agent` parameters.
+`TYPESAFE_API_KEY` is optional when Pi already has TypeSafe credentials or the environment variable is set. A literal key must be a nonempty token without whitespace or control characters and applies only to that classifier request; it is saved in the settings file, masked in the menu and omitted from settings events, prompts and routing records. Without a literal key, Pi's native credential availability check runs before classification. Rejected credentials fall back without retrying. The extension does not change environment variables or register a routing provider. `models` accepts 1–254 unique entries with descriptions of 1–4000 characters. Every entry requires `thinkingLevel`: `minimal`, `low`, `medium`, `high`, `xhigh` or `max`. Existing profiles must add this field; a missing or invalid value disables the whole Jev block and uses the default-priority fallback. Jev entries use exact `provider/model-id` spelling; fuzzy names remain available for explicit `Agent` parameters.
 
-Under `auto`, supplying **either** `model` or `thinking` explicitly skips Jev. An agent-file pin also skips it. In workflows, either `model` or `effort` skips it, and workflow options retain their precedence over agent-file defaults. Inherited models remain eligible for Jev. Under `jev`, these choices supply the fallback model, but do not skip classification. Under `shadow`, they remain the actual choice while Jev records a comparison. Jev changes only the model; Pi still determines the effective thinking level.
+Under `auto`, supplying **either** `model` or `thinking` explicitly skips Jev. An agent-file pin also skips it. In workflows, either `model` or `effort` skips it, and workflow options retain their precedence over agent-file defaults. Inherited models remain eligible for Jev. Under `jev`, these choices supply the fallback model, but do not skip classification. Under `shadow`, they remain the actual choice while Jev records a comparison. A selected Jev profile applies both its model and `thinkingLevel`. Pi clamps the requested thinking level to what that model supports. Shadow and fallback preserve the original model and thinking level.
 
 Automatic choices are limited to authenticated models and the current nonempty Pi model scope, regardless of the `scopeModels` setting. When `scopeModels` is enabled, Jev candidates also respect `enabledModels`. Unavailable candidates are excluded and the selected model is checked again after classification, including any changed scope. Jev failure, confidence below 0.6 or a two-second timeout keeps the default-priority model already selected by the main agent, explicit caller or agent definition, otherwise the existing model. This fallback does not make a second Jev request. Cancellation stops startup without launching a fallback. Queued agents read the current mode and classify after dequeue; nested calls share a separate classifier concurrency limit of four and do not take another agent slot.
 
@@ -696,7 +698,7 @@ Jev applies to fresh tool, nested, workflow, scheduled, RPC and direct-mention s
 
 Project `routingMode` and `customGuideline` replace the global values; omission inherits them, and `customGuideline: false` disables the guideline. A project `jev` block replaces the **whole** global block, including credentials; omitted fields inside that block do not inherit. `"jev": false` disables global Jev. An invalid mode or malformed settings file disables routing. An invalid explicit Jev block disables that block instead of restoring global paid routing. Other settings changes preserve these inheritance rules.
 
-Classifier usage is recorded separately as `routingUsage`, including in `shadow`; it does not consume coding context or workflow output budgets. Its reported cost is added once to the agent and ancestor cost totals, and `reportUsage` can return its token usage to the parent. `routing` records the mode, source, reason, applied `model` and confidence; shadow records `suggestedModel` and leaves `model` unset. `fallbackSource` identifies the default source when a suggestion is observed or Jev falls back. Shadow results show “Jev shadow”. Zero catalog prices are marked `unpriced`; the Agent result shows “Jev price unavailable” instead of treating that as proof the classifier is free.
+Classifier usage is recorded separately as `routingUsage`, including in `shadow`; it does not consume coding context or workflow output budgets. Its reported cost is added once to the agent and ancestor cost totals, and `reportUsage` can return its token usage to the parent. `routing` records the mode, source, reason, applied `model`, requested `thinkingLevel` and confidence; shadow records `suggestedModel` and `suggestedThinkingLevel` and leaves both applied fields unset. `fallbackSource` identifies the default source when a suggestion is observed or Jev falls back. Shadow results show “Jev shadow”. Zero catalog prices are marked `unpriced`; the Agent result shows “Jev price unavailable” instead of treating that as proof the classifier is free.
 
 ## Model Scope
 
@@ -731,7 +733,7 @@ Runtime tuning values set via `/agents` → Settings (max concurrency, max foreg
 
 **Precedence:** project overrides global on any field present in both. Missing fields fall back to the hardcoded defaults (max concurrency `10`, max foreground concurrency `0` = unlimited, default max turns unlimited, grace turns `5`, nested depth `2`, join mode `smart`, defaults enabled).
 
-Routing settings: `routingMode` (`auto | shadow | jev | off`, default `auto`), `customGuideline` (`string | false`, default unset) and `jev` (`{ TYPESAFE_API_KEY?: string, models: { model, description }[] } | false`, default unset). See [Model routing](#model-routing) for examples and the whole-block override rule.
+Routing settings: `routingMode` (`auto | shadow | jev | off`, default `auto`), `customGuideline` (`string | false`, default unset) and `jev` (`{ TYPESAFE_API_KEY?: string, models: { model, description, thinkingLevel }[] } | false`, default unset). See [Model routing](#model-routing) for examples and the whole-block override rule.
 
 **Nested depth** (`maxSubagentDepth`, default `2`): the hard ceiling on [nested delegation](#nested-subagents), counted from the main session (main = 0, its subagents = 1). `0` or `1` disables nesting project-wide regardless of any agent's `allowed_subagents`. Read when a subagent session is built, so a change applies to agents started after it.
 
@@ -861,7 +863,7 @@ The four agent-lifecycle events — `subagents:started`, `:completed`, `:failed`
 
 `usage` answers the other question — what was billed — and so does include `cacheRead`, because the prefix really is re-read and re-charged on every call. It is a pi `Usage`, the same shape pi puts on `ToolResultEvent` and `AssistantMessage`, so `usage.cost.total` is where a listener already expects the money and anything pi adds to `Usage` arrives without a change here. Neither field derives from the other; `tokens` is a view model, `usage` is the data.
 
-Completed/failed payloads and persisted `subagents:record` entries also carry `routing` (`source`, `code`, `reason`, optional `model`, supplied `description`, `confidence`, `unpriced`, `guidelinePath`, `guidelineHash`) and optional `routingUsage` (classifier-only Pi `Usage`). The guideline hash is SHA-256 of the original file contents. Coding `tokens` excludes classifier tokens; total cost includes the reported classifier cost once. Settings events omit `jev.TYPESAFE_API_KEY`.
+Completed/failed payloads and persisted `subagents:record` entries also carry `routing` (`source`, `code`, `reason`, optional `model`, `thinkingLevel`, `suggestedModel`, `suggestedThinkingLevel`, supplied `description`, `confidence`, `unpriced`, `guidelinePath`, `guidelineHash`) and optional `routingUsage` (classifier-only Pi `Usage`). The guideline hash is SHA-256 of the original file contents. Coding `tokens` excludes classifier tokens; total cost includes the reported classifier cost once. Settings events omit `jev.TYPESAFE_API_KEY`.
 
 ## Cross-Extension RPC
 
@@ -1080,7 +1082,7 @@ src/
   invocation-config.ts # Shared tool-parameter schemas (isolation, join, thinking, ...)
   model-resolver.ts   # Model resolution: exact provider/modelId with fuzzy fallback
   model-routing.ts    # Source priority and bounded native Jev classification before startup
-  routing-config.ts   # Minimal Jev model/description and credential config validation
+  routing-config.ts   # Jev model/description/thinking-level and credential config validation
   enabled-models.ts   # Read pi's enabledModels settings (project over global)
   model-scope.ts      # scopeModels allowlist policy, shared by top-level and nested tools
   mention.ts          # `@handle message` grammar: suggestion triggers and send parsing
@@ -1117,6 +1119,7 @@ src/
     agent-mention.ts      # `@` roster (running, resumable, and startable agents) + popup rows
     schedule-menu.ts      # /agents → Scheduled jobs submenu
     model-routing-menu.ts # Guideline/model descriptions and masked API-key editor
+    routing-status.ts  # Read-only effective routing configuration and retained decisions
     select-item.ts        # Collision-safe ctx.ui.select wrapper (numbered rows)
     workflow-card.ts      # Inline workflow card (tool result and session entry)
     workflow-dialog.ts    # /agents → Workflows two-pane inspector

package/dist/agent-manager.js

@@ -504,11 +504,13 @@ export class AgentManager {
                 });
                 record.routing = { ...routed.decision, guidelinePath: policy.guidelinePath, guidelineHash: policy.guidelineHash };
                 if (routed.model && policy.mode === "shadow") {
-                    record.routing = { ...record.routing, code: "shadow", model: undefined, suggestedModel: routed.decision.model,
+                    record.routing = { ...record.routing, code: "shadow", model: undefined, thinkingLevel: undefined, suggestedModel: routed.decision.model,
                         fallbackSource: policy.source, reason: "Jev suggested a model; shadow mode kept the default-priority model" };
                 }
                 else if (routed.model) {
                     options.model = routed.model;
+                    options.thinkingLevel = routed.thinkingLevel;
+                    record.invocation = { ...record.invocation, thinking: routed.thinkingLevel, requestedThinking: undefined };
                 }
             }
             catch {

package/dist/index.js

@@ -2752,7 +2752,7 @@ Terse command-style prompts produce shallow, generic work.
             await showAgentsMenu(ctx);
         }
         else if (choice === "Model routing") {
-            const patch = await showRoutingMenu(ctx);
+            const patch = await showRoutingMenu(ctx, () => manager.listAgents());
             if (patch) {
                 const toast = saveAndEmitChanged({ ...snapshotSettings(), ...patch }, "Model routing settings updated", (event, payload) => pi.events.emit(event, payload), ctx.cwd);
                 ctx.ui.notify(toast.message, toast.level);

package/dist/model-routing.d.ts

@@ -1,4 +1,4 @@
-import type { Api, Model, Usage } from "@earendil-works/pi-ai";
+import type { Api, Model, ThinkingLevel, Usage } from "@earendil-works/pi-ai";
 import type { ExtensionContext } from "@earendil-works/pi-coding-agent";
 import type { JevConfig, RoutingMode } from "./routing-config.js";
 import type { AgentConfig } from "./types.js";
@@ -33,6 +33,8 @@ export interface RoutingDecision {
     code: "baseline" | "explicit" | "off" | "shadow" | "config_unavailable" | "credentials_unavailable" | "guideline_unavailable" | "no_candidates" | "classifier_unavailable" | "cancelled" | "timeout" | "invalid_answer" | "abstained" | "unavailable_choice" | "selected" | "classifier_error";
     model?: string;
     suggestedModel?: string;
+    thinkingLevel?: ThinkingLevel;
+    suggestedThinkingLevel?: ThinkingLevel;
     description?: string;
     confidence?: number;
     unpriced?: boolean;
@@ -42,6 +44,7 @@ export interface RoutingDecision {
 export declare function loadRoutingPolicy(cwd: string, loadedAgents?: Map<string, AgentConfig>): RoutingPolicy;
 /** Added in every description mode and refreshed before each main-agent turn. */
 export declare function routingGuidance(policy: RoutingPolicy): string;
+export declare function eligibleModels(ctx: ExtensionContext): Map<string, Model<Api>>;
 /** Bounded classifier pool, independent of agent concurrency and nesting. */
 export declare class ModelRouter {
     private active;
@@ -49,6 +52,7 @@ export declare class ModelRouter {
     private acquire;
     choose(ctx: ExtensionContext, policy: RoutingPolicy, prompt: string, description: string, baseline: Model<Api> | undefined, signal: AbortSignal, onUsage: (usage: Usage) => void): Promise<{
         model?: Model<Api>;
+        thinkingLevel?: ThinkingLevel;
         decision: RoutingDecision;
     }>;
 }

package/dist/model-routing.js

@@ -59,15 +59,15 @@ export function routingGuidance(policy) {
                 ? `Routing source: Custom guideline (${policy.guidelinePath}). Follow it when choosing Agent model/thinking (or workflow model/effort). Pass your default choice explicitly.\n<custom_routing_guideline>\n${policy.guideline}\n</custom_routing_guideline>`
                 : policy.diagnostic ?? "Custom routing guideline is unavailable. Use the existing model.";
             break;
-        case "jev": guidance = "Routing: Jev chooses the model for fresh agents when neither model nor thinking is explicitly set. Omit both to use automatic routing. Explicit choices and agent-file pins keep their existing precedence.";
+        case "jev": guidance = "Routing: Jev chooses the model and thinking level for fresh agents when neither model nor thinking is explicitly set. Omit both to use automatic routing. Explicit choices and agent-file pins keep their existing precedence.";
     }
     if (policy.mode === "jev")
-        return "Routing mode: jev. Jev gets first choice of model for every fresh delegated task, including explicit model choices and agent-file model pins. Choose an agent and a default model using the guidance below; that choice is the fallback if Jev is unavailable or uncertain. Thinking keeps its existing precedence.\n" + guidance;
+        return "Routing mode: jev. Jev gets first choice of model for every fresh delegated task, including explicit model choices and agent-file model pins. Choose an agent and a default model using the guidance below; that choice is the fallback if Jev is unavailable or uncertain. The selected profile supplies both model and thinking level.\n" + guidance;
     if (policy.mode === "shadow")
         return "Routing mode: shadow. Jev records a suggestion for each fresh delegated task but never changes the model. Choose using the default guidance below, or keep the existing model when no guidance applies.\n" + guidance;
     return guidance && policy.source !== "jev" ? guidance + "\nJev is inactive under auto mode while this routing source applies." : guidance;
 }
-function eligibleModels(ctx) {
+export function eligibleModels(ctx) {
     const scope = ctx.scopedModels;
     const allowed = scope?.length ? new Set(scope.map(entry => `${entry.model.provider}/${entry.model.id}`)) : undefined;
     const enabled = isScopeModelsEnabled() ? resolveEnabledModels(readEnabledModels(ctx.cwd), ctx.modelRegistry, ctx.cwd) : undefined;
@@ -139,7 +139,7 @@ export class ModelRouter {
             release = await this.acquire(controller.signal);
             if (!release)
                 return { decision: { ...decision, code: signal.aborted ? "cancelled" : "timeout", reason: signal.aborted ? "Cancelled" : "Jev timed out" } };
-            const choices = new Map(candidates.map((entry, index) => [`route_${index}`, entry.model]));
+            const choices = new Map(candidates.map((entry, index) => [`route_${index}`, entry]));
             const criteria = { keep_baseline: "Keep the existing model if none of the described models clearly fits the task." };
             for (const [index, entry] of candidates.entries())
                 criteria[`route_${index}`] = entry.description;
@@ -186,16 +186,19 @@ export class ModelRouter {
                 return { decision: { ...decision, code: "invalid_answer", reason: "Jev returned no usable choice" } };
             }
             decision.confidence = answer.confidence;
-            if (policy.mode === "shadow")
-                decision.suggestedModel = choices.get(answer.choice);
+            const profile = choices.get(answer.choice);
+            if (policy.mode === "shadow") {
+                decision.suggestedModel = profile?.model;
+                decision.suggestedThinkingLevel = profile?.thinkingLevel;
+            }
             if (answer.choice === "keep_baseline" || answer.confidence < 0.6) {
                 return { decision: { ...decision, code: "abstained", reason: "Jev kept the existing model" } };
             }
-            const selected = choices.get(answer.choice);
+            const selected = profile?.model;
             const model = selected ? eligibleModels(ctx).get(selected) : undefined;
             if (!model || signal.aborted)
                 return { decision: { ...decision, code: "unavailable_choice", reason: "Selected model is no longer available in scope" } };
-            return { model, decision: { ...decision, fallbackSource: undefined, code: "selected", model: selected, description: candidates.find(entry => entry.model === selected)?.description, reason: "Jev selected a configured model" } };
+            return { model, thinkingLevel: profile?.thinkingLevel, decision: { ...decision, fallbackSource: undefined, code: "selected", model: selected, thinkingLevel: profile?.thinkingLevel, description: profile?.description, reason: "Jev selected a configured model profile" } };
         }
         catch {
             // Provider errors may contain credentials. Keep diagnostics code-owned.

package/dist/routing-config.d.ts

@@ -1,9 +1,12 @@
+import type { ThinkingLevel } from "@earendil-works/pi-ai";
+export declare const ROUTING_THINKING_LEVELS: readonly ["minimal", "low", "medium", "high", "xhigh", "max"];
 export type RoutingMode = "auto" | "shadow" | "jev" | "off";
 export interface JevConfig {
     TYPESAFE_API_KEY?: string;
     models: {
         model: string;
         description: string;
+        thinkingLevel: ThinkingLevel;
     }[];
 }
 /** Validate the whole block; never merge candidate lists or credentials. */

package/dist/routing-config.js

@@ -1,3 +1,4 @@
+export const ROUTING_THINKING_LEVELS = ["minimal", "low", "medium", "high", "xhigh", "max"];
 /** Validate the whole block; never merge candidate lists or credentials. */
 export function parseJevConfig(raw) {
     if (raw === false)
@@ -20,15 +21,18 @@ export function parseJevConfig(raw) {
         if (!entry || typeof entry !== "object" || Array.isArray(entry))
             throw new Error("Each Jev model needs model and description");
         const candidate = entry;
-        if (Object.keys(candidate).some(key => key !== "model" && key !== "description") ||
+        if (Object.keys(candidate).some(key => key !== "model" && key !== "description" && key !== "thinkingLevel") ||
             typeof candidate.model !== "string" || !/^[^\s/]+\/\S+$/.test(candidate.model) ||
             typeof candidate.description !== "string" || !candidate.description.trim() || candidate.description.length > 4000) {
             throw new Error("Each Jev model needs an exact provider/model-id and a description of 1–4000 characters");
         }
+        const thinkingLevel = ROUTING_THINKING_LEVELS.find(level => level === candidate.thinkingLevel);
+        if (!thinkingLevel)
+            throw new Error("Each Jev model requires thinkingLevel: minimal, low, medium, high, xhigh or max");
         if (seen.has(candidate.model))
             throw new Error("jev.models contains duplicate models");
         seen.add(candidate.model);
-        return { model: candidate.model, description: candidate.description.trim() };
+        return { model: candidate.model, description: candidate.description.trim(), thinkingLevel };
     });
     return { models, ...(typeof value.TYPESAFE_API_KEY === "string" ? { TYPESAFE_API_KEY: value.TYPESAFE_API_KEY } : {}) };
 }

package/dist/ui/model-routing-menu.d.ts

@@ -1,8 +1,9 @@
 import type { ExtensionCommandContext } from "@earendil-works/pi-coding-agent";
 import { type SubagentsSettings } from "../settings.js";
+import type { AgentRecord } from "../types.js";
 type RoutingSettings = Pick<SubagentsSettings, "routingMode" | "customGuideline" | "jev">;
 /** Input handles paste/editing, but its unmasked renderer is never called. */
 export declare function maskedApiKey(ctx: ExtensionCommandContext): Promise<string | undefined>;
 /** Simple mode, guideline, models and credentials; saves project overrides. */
-export declare function showRoutingMenu(ctx: ExtensionCommandContext): Promise<RoutingSettings | undefined>;
+export declare function showRoutingMenu(ctx: ExtensionCommandContext, records?: () => AgentRecord[]): Promise<RoutingSettings | undefined>;
 export {};

package/dist/ui/model-routing-menu.js

@@ -1,7 +1,8 @@
 import { Input, Text } from "@earendil-works/pi-tui";
 import { loadRoutingPolicy } from "../model-routing.js";
-import { parseJevConfig } from "../routing-config.js";
+import { parseJevConfig, ROUTING_THINKING_LEVELS } from "../routing-config.js";
 import { loadSettings, projectRoutingSettings } from "../settings.js";
+import { showRoutingStatus } from "./routing-status.js";
 /** Input handles paste/editing, but its unmasked renderer is never called. */
 export async function maskedApiKey(ctx) {
     return ctx.ui.custom((_tui, _theme, _kb, done) => {
@@ -16,7 +17,7 @@ export async function maskedApiKey(ctx) {
     });
 }
 /** Simple mode, guideline, models and credentials; saves project overrides. */
-export async function showRoutingMenu(ctx) {
+export async function showRoutingMenu(ctx, records = () => []) {
     const settings = loadSettings(ctx.cwd);
     const local = projectRoutingSettings(ctx.cwd);
     const policy = loadRoutingPolicy(ctx.cwd);
@@ -28,10 +29,14 @@ export async function showRoutingMenu(ctx) {
             : policy.mode === "jev" ? `Jev first; fallback: ${labels[policy.fallbackSource ?? "baseline"]}.${policy.jev ? "" : " Configure Jev models and credentials to use Jev."}`
                 : policy.diagnostic ?? inactive;
     const choice = await ctx.ui.select(`Model routing: ${policy.mode} — ${note || labels[policy.source]}`, [
-        "Routing mode", "Custom guideline path", "Jev models and descriptions", "Typesafe API key", "Use Pi/environment credentials", "Disable custom guideline", "Disable Jev", "Back",
+        "Runtime status", "Routing mode", "Custom guideline path", "Jev models and descriptions", "Typesafe API key", "Use Pi/environment credentials", "Disable custom guideline", "Disable Jev", "Back",
     ]);
     if (!choice || choice === "Back")
         return;
+    if (choice === "Runtime status") {
+        await showRoutingStatus(ctx, records);
+        return;
+    }
     if (choice === "Routing mode") {
         const modes = [
             { mode: "auto", label: "auto — default priority: agents, guideline, Jev, existing model" },
@@ -73,7 +78,7 @@ export async function showRoutingMenu(ctx) {
         }
     }
     for (;;) {
-        const options = [...models.map((entry, index) => `${index + 1}. ${entry.model}`), "Add model", "Save", "Cancel"];
+        const options = [...models.map((entry, index) => `${index + 1}. ${entry.model} (${entry.thinkingLevel})`), "Add model", "Save", "Cancel"];
         const action = await ctx.ui.select("Jev models — describe which tasks each model should handle", options);
         if (!action || action === "Cancel")
             return;
@@ -103,7 +108,11 @@ export async function showRoutingMenu(ctx) {
         const description = await ctx.ui.editor("Tasks this model is suitable for", current?.description ?? "");
         if (!description?.trim())
             continue;
-        const entry = { model: model.trim(), description: description.trim() };
+        const selectedLevel = await ctx.ui.select(`Thinking level (required${current ? `; current: ${current.thinkingLevel}` : ""})`, [...ROUTING_THINKING_LEVELS]);
+        const thinkingLevel = ROUTING_THINKING_LEVELS.find(level => level === selectedLevel);
+        if (!thinkingLevel)
+            continue;
+        const entry = { model: model.trim(), description: description.trim(), thinkingLevel };
         if (current)
             models[index] = entry;
         else

package/dist/ui/routing-status.d.ts

@@ -0,0 +1,5 @@
+import type { ExtensionCommandContext } from "@earendil-works/pi-coding-agent";
+import type { AgentRecord } from "../types.js";
+/** Read current configuration and retained decisions without making a paid classifier request. */
+export declare function routingStatusText(ctx: ExtensionCommandContext, records: readonly AgentRecord[]): Promise<string>;
+export declare function showRoutingStatus(ctx: ExtensionCommandContext, records: () => AgentRecord[]): Promise<void>;

package/dist/ui/routing-status.js

@@ -0,0 +1,113 @@
+import { matchesKey, Text } from "@earendil-works/pi-tui";
+import { eligibleModels, loadRoutingPolicy } from "../model-routing.js";
+import { isScopeModelsEnabled } from "../model-scope.js";
+import { loadRoutingSettings, projectRoutingSettings } from "../settings.js";
+/** Read current configuration and retained decisions without making a paid classifier request. */
+export async function routingStatusText(ctx, records) {
+    const { settings, guidelineFile } = loadRoutingSettings(ctx.cwd);
+    const local = projectRoutingSettings(ctx.cwd);
+    const policy = loadRoutingPolicy(ctx.cwd);
+    const config = settings.jev;
+    const apiKey = config ? config.TYPESAFE_API_KEY : undefined;
+    const available = eligibleModels(ctx);
+    const labels = { agents: "Custom agents", guideline: "Custom guideline", jev: "Jev", baseline: "Existing model" };
+    const lines = [
+        `Directory: ${ctx.cwd}`,
+        `Mode: ${policy.mode} (${local.routingMode !== undefined ? "project" : settings.routingMode !== undefined ? "global" : "default"})`,
+        `Routing source: ${labels[policy.source]}`,
+        `Fallback source: ${labels[policy.fallbackSource ?? (policy.source === "jev" ? "baseline" : policy.source)]}`,
+        `Parent model: ${ctx.model ? `${ctx.model.provider}/${ctx.model.id}` : "Pi default"}`,
+        `Custom agents: ${policy.agents?.map(agent => agent.name).join(", ") || "none active in this policy"}`,
+        `Guideline: ${guidelineFile ?? "not configured"}${policy.source !== "guideline" && policy.fallbackSource !== "guideline" ? " (inactive)" : ""}`,
+        `Jev config: ${config ? "valid" : config === false ? "disabled or invalid; check subagents.json" : "not configured"} (${local.jev !== undefined ? "project" : settings.jev !== undefined ? "global" : "default"})`,
+        `Scope: Pi scoped models ${ctx.scopedModels?.length ? "active" : "unrestricted"}; enabledModels filter ${isScopeModelsEnabled() ? "on" : "off"}`,
+    ];
+    if (policy.diagnostic)
+        lines.push(`Diagnostic: ${policy.diagnostic}`);
+    const classifier = ctx.modelRegistry.findOfType("classifier", "typesafe", "jev-latest");
+    lines.push(`Jev classifier: ${classifier ? "available" : "unavailable in Pi registry"}`);
+    if (apiKey) {
+        lines.push("Credentials: configured key present (acceptance checked on next route)");
+    }
+    else {
+        const controller = new AbortController();
+        let timer;
+        try {
+            const availableCredentials = await Promise.race([
+                ctx.modelRegistry.getAvailableOfType("classifier", "typesafe", { signal: controller.signal }),
+                new Promise(resolve => { timer = setTimeout(() => { controller.abort(); resolve(undefined); }, 2000); }),
+            ]);
+            lines.push(`Credentials: ${availableCredentials === undefined ? "check timed out" : availableCredentials.some(model => model.id === "jev-latest") ? "Pi/environment credentials available (acceptance checked on next route)" : "missing Pi/environment credentials"}`);
+        }
+        catch {
+            lines.push("Credentials: availability check failed");
+        }
+        finally {
+            clearTimeout(timer);
+        }
+    }
+    lines.push("", "Configured profiles:");
+    if (config) {
+        for (const profile of config.models) {
+            lines.push(`${profile.model} | thinking: ${profile.thinkingLevel} | ${available.has(profile.model) ? "eligible" : "unavailable or excluded by scope"}`, `  ${profile.description}`);
+        }
+    }
+    else
+        lines.push("None. Every profile requires model, description and thinkingLevel.");
+    lines.push("", "Recent retained agents (latest 10; includes nested/workflow agents):");
+    const recent = [...records].filter(record => record.routing).sort((a, b) => b.startedAt - a.startedAt).slice(0, 10);
+    if (!recent.length)
+        lines.push("No routing decisions yet. Start a fresh subagent; resumed agents do not reroute.");
+    for (const record of recent) {
+        const route = record.routing;
+        lines.push(`${new Date(record.startedAt).toISOString()} | ${record.id} | ${record.status}`, `  Mode: ${route.mode} | Source: ${route.source} | Result: ${route.code}`, `  ${route.reason}`);
+        if (route.model)
+            lines.push(`  Selected: ${route.model} | requested thinking: ${route.thinkingLevel ?? "inherited"}`);
+        if (route.suggestedModel)
+            lines.push(`  Shadow suggestion: ${route.suggestedModel} | thinking: ${route.suggestedThinkingLevel ?? "inherited"}`);
+        if (record.invocation?.modelId)
+            lines.push(`  Actual: ${record.invocation.modelId} | effective thinking: ${record.invocation.thinking ?? "unknown"}`);
+        if (route.confidence !== undefined)
+            lines.push(`  Confidence: ${(route.confidence * 100).toFixed(1)}%`);
+        if (record.routingUsage)
+            lines.push(`  Classifier tokens: ${record.routingUsage.totalTokens} | ${route.unpriced ? "price unavailable" : `reported cost: $${record.routingUsage.cost.total}`}`);
+    }
+    lines.push("", "Snapshot only. Refresh to reload settings and retained decisions. Opening this page does not classify a task.");
+    const text = lines.join("\n");
+    return apiKey ? text.replaceAll(apiKey, "[redacted]") : text;
+}
+export async function showRoutingStatus(ctx, records) {
+    let refresh = true;
+    while (refresh) {
+        const content = await routingStatusText(ctx, records());
+        refresh = await ctx.ui.custom((tui, _theme, _kb, done) => {
+            let offset = 0;
+            let maxOffset = 0;
+            return {
+                render(width) {
+                    const rows = new Text(content, 0, 0).render(width);
+                    const height = Math.max(1, tui.terminal.rows - 6);
+                    maxOffset = Math.max(0, rows.length - height);
+                    offset = Math.min(offset, maxOffset);
+                    return [...new Text("Routing runtime status | Up/Down: scroll | r: refresh | Esc: back", 0, 0).render(width), ...rows.slice(offset, offset + height)];
+                },
+                invalidate() { },
+                handleInput(data) {
+                    if (matchesKey(data, "escape") || matchesKey(data, "q")) {
+                        done(false);
+                        return;
+                    }
+                    if (matchesKey(data, "r")) {
+                        done(true);
+                        return;
+                    }
+                    if (matchesKey(data, "up"))
+                        offset = Math.max(0, offset - 1);
+                    if (matchesKey(data, "down"))
+                        offset = Math.min(maxOffset, offset + 1);
+                    tui.requestRender();
+                },
+            };
+        });
+    }
+}

package/docs/rpc.md

@@ -55,9 +55,9 @@ Four things that are not obvious from the tables:
 
 ### Model routing
 
-RPC and the manager registry follow the [same routingMode setting](../README.md#model-routing) as the tools. Under `auto` (default), enabled custom agents and a configured guideline take priority; with Jev active, a fresh spawn omitting both `model` and `thinkingLevel` is classified before worktree/session creation. Providing either field skips classification only under `auto`. Under `jev`, Jev chooses first, including over explicit or agent-file models; missing credentials, invalid configuration, uncertainty or errors keep the default-priority choice. Under `shadow`, the same check records a suggestion but preserves that choice. Under `off`, routing guidance and Jev are disabled. `null` means omitted. No mode creates an extra main-agent turn to interpret descriptions or Markdown. `awaitStartup` includes classification and its two-second deadline, while cancellation stops startup.
+RPC and the manager registry follow the [same routingMode setting](../README.md#model-routing) as the tools. Under `auto` (default), enabled custom agents and a configured guideline take priority; with Jev active, a fresh spawn omitting both `model` and `thinkingLevel` is classified before worktree/session creation. Providing either field skips classification only under `auto`. A selected Jev profile applies its model and required `thinkingLevel` together; Pi clamps the level to model support. Shadow and fallback preserve both original values. Under `jev`, Jev chooses first, including over explicit or agent-file models; missing credentials, invalid configuration, uncertainty or errors keep the default-priority choice. Under `shadow`, the same check records a suggestion but preserves that choice. Under `off`, routing guidance and Jev are disabled. `null` means omitted. No mode creates an extra main-agent turn to interpret descriptions or Markdown. `awaitStartup` includes classification and its two-second deadline, while cancellation stops startup.
 
-Completion events expose the credential-free `routing` decision and optional classifier-only `routingUsage`. `routing.mode` identifies the mode, `model` an applied Jev choice, `suggestedModel` an observed shadow choice, and `fallbackSource` the preserved default source. Classifier tokens are separate from coding token totals; reported classifier cost, including shadow requests, is included in total cost once. `routing.unpriced` means the catalog does not provide a price. Settings events omit literal TypeSafe keys.
+Completion events expose the credential-free `routing` decision and optional classifier-only `routingUsage`. `routing.mode` identifies the mode, `model` and `thinkingLevel` an applied Jev profile, `suggestedModel` and `suggestedThinkingLevel` an observed shadow profile, and `fallbackSource` the preserved default source. Classifier tokens are separate from coding token totals; reported classifier cost, including shadow requests, is included in total cost once. `routing.unpriced` means the catalog does not provide a price. Settings events omit literal TypeSafe keys.
 
 ### Names that look right and are not
 

package/docs/workflows.md

@@ -308,7 +308,7 @@ A run's concurrency limit is its own, independent of the session's `maxConcurren
 
 ### Settings and the CLI flag
 
-Workflow children follow [Model routing](../README.md#model-routing). With `routingMode: "auto"` (default), custom agents come first, then a main-agent Markdown guideline, then optional Jev, then the existing model. The main agent receives the guideline before writing the script and can express its choice through `agent(prompt, { model, effort })`. Either explicit option skips Jev under `auto`; workflow options retain their precedence over agent-file defaults. Under `jev`, Jev chooses first and those defaults remain the fallback on uncertainty, missing credentials or errors. Under `shadow`, Jev records a suggestion without changing the model; under `off`, routing guidance and Jev are disabled. An inherited parent model is eligible for Jev. Resuming a child does not classify again in any mode.
+Workflow children follow [Model routing](../README.md#model-routing). With `routingMode: "auto"` (default), custom agents come first, then a main-agent Markdown guideline, then optional Jev, then the existing model. The main agent receives the guideline before writing the script and can express its choice through `agent(prompt, { model, effort })`. Either explicit option skips Jev under `auto`; workflow options retain their precedence over agent-file defaults. A selected Jev profile applies its model and required `thinkingLevel` together; Pi clamps the level to model support. Shadow and fallback preserve both original values. Under `jev`, Jev chooses first and those defaults remain the fallback on uncertainty, missing credentials or errors. Under `shadow`, Jev records a suggestion without changing the model; under `off`, routing guidance and Jev are disabled. An inherited parent model is eligible for Jev. Resuming a child does not classify again in any mode.
 
 Jev classification happens once at child startup through Pi's native API, with a separate concurrency limit of four. Uncertainty, errors or a two-second timeout keep the existing model; stopping the workflow cancels classification without launching another child. Classifier tokens do not affect `budget.spent()` or coding context. Reported classifier cost rolls into child/ancestor cost totals once; classifier usage and the routing decision remain separately available on the agent record. Catalog-zero classifier prices mean unavailable pricing.
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@diousk/pi-subagents-fast",
-  "version": "0.22.0",
+  "version": "0.24.0",
   "description": "A pi extension that brings Claude Code-like sub-agents and workflow orchestration to pi — parallel execution, live widget, fleet view, custom agent types, mid-run steering, dynamic workflows, Claude Code compatibility, look and feel.",
   "author": "tintinweb",
   "license": "MIT",

package/src/agent-manager.ts

@@ -742,10 +742,12 @@ export class AgentManager {
           });
         record.routing = { ...routed.decision, guidelinePath: policy.guidelinePath, guidelineHash: policy.guidelineHash };
         if (routed.model && policy.mode === "shadow") {
-          record.routing = { ...record.routing, code: "shadow", model: undefined, suggestedModel: routed.decision.model,
+          record.routing = { ...record.routing, code: "shadow", model: undefined, thinkingLevel: undefined, suggestedModel: routed.decision.model,
             fallbackSource: policy.source, reason: "Jev suggested a model; shadow mode kept the default-priority model" };
         } else if (routed.model) {
           options.model = routed.model;
+          options.thinkingLevel = routed.thinkingLevel;
+          record.invocation = { ...record.invocation, thinking: routed.thinkingLevel, requestedThinking: undefined };
         }
       } catch {
         record.routing.code = "classifier_error";

package/src/index.ts

@@ -2994,7 +2994,7 @@ Terse command-style prompts produce shallow, generic work.
       await showSettings(ctx);
       await showAgentsMenu(ctx);
     } else if (choice === "Model routing") {
-      const patch = await showRoutingMenu(ctx);
+      const patch = await showRoutingMenu(ctx, () => manager.listAgents());
       if (patch) {
         const toast = saveAndEmitChanged({ ...snapshotSettings(), ...patch }, "Model routing settings updated", (event, payload) => pi.events.emit(event, payload), ctx.cwd);
         ctx.ui.notify(toast.message, toast.level);

package/src/model-routing.ts

@@ -1,6 +1,6 @@
 import { createHash } from "node:crypto";
 import { readFileSync, statSync } from "node:fs";
-import type { Api, ClassifierResult, Model, Usage } from "@earendil-works/pi-ai";
+import type { Api, ClassifierResult, Model, ThinkingLevel, Usage } from "@earendil-works/pi-ai";
 import type { ExtensionContext } from "@earendil-works/pi-coding-agent";
 import { loadCustomAgents } from "./custom-agents.js";
 import { isModelInScope, readEnabledModels, resolveEnabledModels } from "./enabled-models.js";
@@ -40,6 +40,8 @@ export interface RoutingDecision {
     "cancelled" | "timeout" | "invalid_answer" | "abstained" | "unavailable_choice" | "selected" | "classifier_error";
   model?: string;
   suggestedModel?: string;
+  thinkingLevel?: ThinkingLevel;
+  suggestedThinkingLevel?: ThinkingLevel;
   description?: string;
   confidence?: number;
   unpriced?: boolean;
@@ -93,14 +95,14 @@ export function routingGuidance(policy: RoutingPolicy): string {
       ? `Routing source: Custom guideline (${policy.guidelinePath}). Follow it when choosing Agent model/thinking (or workflow model/effort). Pass your default choice explicitly.\n<custom_routing_guideline>\n${policy.guideline}\n</custom_routing_guideline>`
       : policy.diagnostic ?? "Custom routing guideline is unavailable. Use the existing model.";
       break;
-    case "jev": guidance = "Routing: Jev chooses the model for fresh agents when neither model nor thinking is explicitly set. Omit both to use automatic routing. Explicit choices and agent-file pins keep their existing precedence.";
+    case "jev": guidance = "Routing: Jev chooses the model and thinking level for fresh agents when neither model nor thinking is explicitly set. Omit both to use automatic routing. Explicit choices and agent-file pins keep their existing precedence.";
   }
-  if (policy.mode === "jev") return "Routing mode: jev. Jev gets first choice of model for every fresh delegated task, including explicit model choices and agent-file model pins. Choose an agent and a default model using the guidance below; that choice is the fallback if Jev is unavailable or uncertain. Thinking keeps its existing precedence.\n" + guidance;
+  if (policy.mode === "jev") return "Routing mode: jev. Jev gets first choice of model for every fresh delegated task, including explicit model choices and agent-file model pins. Choose an agent and a default model using the guidance below; that choice is the fallback if Jev is unavailable or uncertain. The selected profile supplies both model and thinking level.\n" + guidance;
   if (policy.mode === "shadow") return "Routing mode: shadow. Jev records a suggestion for each fresh delegated task but never changes the model. Choose using the default guidance below, or keep the existing model when no guidance applies.\n" + guidance;
   return guidance && policy.source !== "jev" ? guidance + "\nJev is inactive under auto mode while this routing source applies." : guidance;
 }
 
-function eligibleModels(ctx: ExtensionContext): Map<string, Model<Api>> {
+export function eligibleModels(ctx: ExtensionContext): Map<string, Model<Api>> {
   const scope = ctx.scopedModels;
   const allowed = scope?.length ? new Set(scope.map(entry => `${entry.model.provider}/${entry.model.id}`)) : undefined;
   const enabled = isScopeModelsEnabled() ? resolveEnabledModels(readEnabledModels(ctx.cwd), ctx.modelRegistry, ctx.cwd) : undefined;
@@ -148,7 +150,7 @@ export class ModelRouter {
     baseline: Model<Api> | undefined,
     signal: AbortSignal,
     onUsage: (usage: Usage) => void,
-  ): Promise<{ model?: Model<Api>; decision: RoutingDecision }> {
+  ): Promise<{ model?: Model<Api>; thinkingLevel?: ThinkingLevel; decision: RoutingDecision }> {
     const decision: RoutingDecision = { mode: policy.mode, source: "jev", fallbackSource: policy.fallbackSource ?? (policy.source === "jev" ? "baseline" : policy.source), code: "baseline", reason: "Using the default-priority model" };
     const config = policy.jev;
     if (policy.mode === "off" || (policy.mode === "auto" && policy.source !== "jev")) return { decision: { ...decision, source: policy.source } };
@@ -169,7 +171,7 @@ export class ModelRouter {
     try {
       release = await this.acquire(controller.signal);
       if (!release) return { decision: { ...decision, code: signal.aborted ? "cancelled" : "timeout", reason: signal.aborted ? "Cancelled" : "Jev timed out" } };
-      const choices = new Map(candidates.map((entry, index) => [`route_${index}`, entry.model]));
+      const choices = new Map(candidates.map((entry, index) => [`route_${index}`, entry]));
       const criteria: Record<string, string> = { keep_baseline: "Keep the existing model if none of the described models clearly fits the task." };
       for (const [index, entry] of candidates.entries()) criteria[`route_${index}`] = entry.description;
       const cancelled = new Promise<undefined>(resolve => {
@@ -208,14 +210,18 @@ export class ModelRouter {
         return { decision: { ...decision, code: "invalid_answer", reason: "Jev returned no usable choice" } };
       }
       decision.confidence = answer.confidence;
-      if (policy.mode === "shadow") decision.suggestedModel = choices.get(answer.choice);
+      const profile = choices.get(answer.choice);
+      if (policy.mode === "shadow") {
+        decision.suggestedModel = profile?.model;
+        decision.suggestedThinkingLevel = profile?.thinkingLevel;
+      }
       if (answer.choice === "keep_baseline" || answer.confidence < 0.6) {
         return { decision: { ...decision, code: "abstained", reason: "Jev kept the existing model" } };
       }
-      const selected = choices.get(answer.choice);
+      const selected = profile?.model;
       const model = selected ? eligibleModels(ctx).get(selected) : undefined;
       if (!model || signal.aborted) return { decision: { ...decision, code: "unavailable_choice", reason: "Selected model is no longer available in scope" } };
-      return { model, decision: { ...decision, fallbackSource: undefined, code: "selected", model: selected, description: candidates.find(entry => entry.model === selected)?.description, reason: "Jev selected a configured model" } };
+      return { model, thinkingLevel: profile?.thinkingLevel, decision: { ...decision, fallbackSource: undefined, code: "selected", model: selected, thinkingLevel: profile?.thinkingLevel, description: profile?.description, reason: "Jev selected a configured model profile" } };
     } catch {
       // Provider errors may contain credentials. Keep diagnostics code-owned.
       return { decision: { ...decision, code: "classifier_error", reason: "Jev could not choose a model; using the existing model" } };

package/src/routing-config.ts

@@ -1,8 +1,12 @@
+import type { ThinkingLevel } from "@earendil-works/pi-ai";
+
+export const ROUTING_THINKING_LEVELS = ["minimal", "low", "medium", "high", "xhigh", "max"] as const satisfies readonly ThinkingLevel[];
+
 export type RoutingMode = "auto" | "shadow" | "jev" | "off";
 
 export interface JevConfig {
   TYPESAFE_API_KEY?: string;
-  models: { model: string; description: string }[];
+  models: { model: string; description: string; thinkingLevel: ThinkingLevel }[];
 }
 
 /** Validate the whole block; never merge candidate lists or credentials. */
@@ -24,14 +28,16 @@ export function parseJevConfig(raw: unknown): JevConfig | false {
   const models = value.models.map((entry: unknown) => {
     if (!entry || typeof entry !== "object" || Array.isArray(entry)) throw new Error("Each Jev model needs model and description");
     const candidate = entry as Record<string, unknown>;
-    if (Object.keys(candidate).some(key => key !== "model" && key !== "description") ||
+    if (Object.keys(candidate).some(key => key !== "model" && key !== "description" && key !== "thinkingLevel") ||
       typeof candidate.model !== "string" || !/^[^\s/]+\/\S+$/.test(candidate.model) ||
       typeof candidate.description !== "string" || !candidate.description.trim() || candidate.description.length > 4000) {
       throw new Error("Each Jev model needs an exact provider/model-id and a description of 1–4000 characters");
     }
+    const thinkingLevel = ROUTING_THINKING_LEVELS.find(level => level === candidate.thinkingLevel);
+    if (!thinkingLevel) throw new Error("Each Jev model requires thinkingLevel: minimal, low, medium, high, xhigh or max");
     if (seen.has(candidate.model)) throw new Error("jev.models contains duplicate models");
     seen.add(candidate.model);
-    return { model: candidate.model, description: candidate.description.trim() };
+    return { model: candidate.model, description: candidate.description.trim(), thinkingLevel };
   });
   return { models, ...(typeof value.TYPESAFE_API_KEY === "string" ? { TYPESAFE_API_KEY: value.TYPESAFE_API_KEY } : {}) };
 }

package/src/ui/model-routing-menu.ts

@@ -1,8 +1,10 @@
 import type { ExtensionCommandContext } from "@earendil-works/pi-coding-agent";
 import { Input, Text } from "@earendil-works/pi-tui";
 import { loadRoutingPolicy } from "../model-routing.js";
-import { parseJevConfig, type RoutingMode } from "../routing-config.js";
+import { parseJevConfig, ROUTING_THINKING_LEVELS, type RoutingMode } from "../routing-config.js";
 import { loadSettings, projectRoutingSettings, type SubagentsSettings } from "../settings.js";
+import type { AgentRecord } from "../types.js";
+import { showRoutingStatus } from "./routing-status.js";
 
 type RoutingSettings = Pick<SubagentsSettings, "routingMode" | "customGuideline" | "jev">;
 
@@ -21,7 +23,7 @@ export async function maskedApiKey(ctx: ExtensionCommandContext): Promise<string
 }
 
 /** Simple mode, guideline, models and credentials; saves project overrides. */
-export async function showRoutingMenu(ctx: ExtensionCommandContext): Promise<RoutingSettings | undefined> {
+export async function showRoutingMenu(ctx: ExtensionCommandContext, records: () => AgentRecord[] = () => []): Promise<RoutingSettings | undefined> {
   const settings = loadSettings(ctx.cwd);
   const local = projectRoutingSettings(ctx.cwd);
   const policy = loadRoutingPolicy(ctx.cwd);
@@ -33,9 +35,13 @@ export async function showRoutingMenu(ctx: ExtensionCommandContext): Promise<Rou
     : policy.mode === "jev" ? `Jev first; fallback: ${labels[policy.fallbackSource ?? "baseline"]}.${policy.jev ? "" : " Configure Jev models and credentials to use Jev."}`
     : policy.diagnostic ?? inactive;
   const choice = await ctx.ui.select(`Model routing: ${policy.mode} — ${note || labels[policy.source]}`, [
-    "Routing mode", "Custom guideline path", "Jev models and descriptions", "Typesafe API key", "Use Pi/environment credentials", "Disable custom guideline", "Disable Jev", "Back",
+    "Runtime status", "Routing mode", "Custom guideline path", "Jev models and descriptions", "Typesafe API key", "Use Pi/environment credentials", "Disable custom guideline", "Disable Jev", "Back",
   ]);
   if (!choice || choice === "Back") return;
+  if (choice === "Runtime status") {
+    await showRoutingStatus(ctx, records);
+    return;
+  }
   if (choice === "Routing mode") {
     const modes: { mode: RoutingMode; label: string }[] = [
       { mode: "auto", label: "auto — default priority: agents, guideline, Jev, existing model" },
@@ -65,7 +71,7 @@ export async function showRoutingMenu(ctx: ExtensionCommandContext): Promise<Rou
     catch (err) { ctx.ui.notify(err instanceof Error ? err.message : "Invalid Jev settings", "warning"); return; }
   }
   for (;;) {
-    const options = [...models.map((entry, index) => `${index + 1}. ${entry.model}`), "Add model", "Save", "Cancel"];
+    const options = [...models.map((entry, index) => `${index + 1}. ${entry.model} (${entry.thinkingLevel})`), "Add model", "Save", "Cancel"];
     const action = await ctx.ui.select("Jev models — describe which tasks each model should handle", options);
     if (!action || action === "Cancel") return;
     if (action === "Save") {
@@ -83,7 +89,10 @@ export async function showRoutingMenu(ctx: ExtensionCommandContext): Promise<Rou
     if (!model) continue;
     const description = await ctx.ui.editor("Tasks this model is suitable for", current?.description ?? "");
     if (!description?.trim()) continue;
-    const entry = { model: model.trim(), description: description.trim() };
+    const selectedLevel = await ctx.ui.select(`Thinking level (required${current ? `; current: ${current.thinkingLevel}` : ""})`, [...ROUTING_THINKING_LEVELS]);
+    const thinkingLevel = ROUTING_THINKING_LEVELS.find(level => level === selectedLevel);
+    if (!thinkingLevel) continue;
+    const entry = { model: model.trim(), description: description.trim(), thinkingLevel };
     if (current) models[index] = entry;
     else models.push(entry);
   }

package/src/ui/routing-status.ts

@@ -0,0 +1,97 @@
+import type { ExtensionCommandContext } from "@earendil-works/pi-coding-agent";
+import { matchesKey, Text } from "@earendil-works/pi-tui";
+import { eligibleModels, loadRoutingPolicy } from "../model-routing.js";
+import { isScopeModelsEnabled } from "../model-scope.js";
+import { loadRoutingSettings, projectRoutingSettings } from "../settings.js";
+import type { AgentRecord } from "../types.js";
+
+/** Read current configuration and retained decisions without making a paid classifier request. */
+export async function routingStatusText(ctx: ExtensionCommandContext, records: readonly AgentRecord[]): Promise<string> {
+  const { settings, guidelineFile } = loadRoutingSettings(ctx.cwd);
+  const local = projectRoutingSettings(ctx.cwd);
+  const policy = loadRoutingPolicy(ctx.cwd);
+  const config = settings.jev;
+  const apiKey = config ? config.TYPESAFE_API_KEY : undefined;
+  const available = eligibleModels(ctx);
+  const labels = { agents: "Custom agents", guideline: "Custom guideline", jev: "Jev", baseline: "Existing model" };
+  const lines = [
+    `Directory: ${ctx.cwd}`,
+    `Mode: ${policy.mode} (${local.routingMode !== undefined ? "project" : settings.routingMode !== undefined ? "global" : "default"})`,
+    `Routing source: ${labels[policy.source]}`,
+    `Fallback source: ${labels[policy.fallbackSource ?? (policy.source === "jev" ? "baseline" : policy.source)]}`,
+    `Parent model: ${ctx.model ? `${ctx.model.provider}/${ctx.model.id}` : "Pi default"}`,
+    `Custom agents: ${policy.agents?.map(agent => agent.name).join(", ") || "none active in this policy"}`,
+    `Guideline: ${guidelineFile ?? "not configured"}${policy.source !== "guideline" && policy.fallbackSource !== "guideline" ? " (inactive)" : ""}`,
+    `Jev config: ${config ? "valid" : config === false ? "disabled or invalid; check subagents.json" : "not configured"} (${local.jev !== undefined ? "project" : settings.jev !== undefined ? "global" : "default"})`,
+    `Scope: Pi scoped models ${ctx.scopedModels?.length ? "active" : "unrestricted"}; enabledModels filter ${isScopeModelsEnabled() ? "on" : "off"}`,
+  ];
+  if (policy.diagnostic) lines.push(`Diagnostic: ${policy.diagnostic}`);
+  const classifier = ctx.modelRegistry.findOfType("classifier", "typesafe", "jev-latest");
+  lines.push(`Jev classifier: ${classifier ? "available" : "unavailable in Pi registry"}`);
+  if (apiKey) {
+    lines.push("Credentials: configured key present (acceptance checked on next route)");
+  } else {
+    const controller = new AbortController();
+    let timer: ReturnType<typeof setTimeout> | undefined;
+    try {
+      const availableCredentials = await Promise.race([
+        ctx.modelRegistry.getAvailableOfType("classifier", "typesafe", { signal: controller.signal }),
+        new Promise<undefined>(resolve => { timer = setTimeout(() => { controller.abort(); resolve(undefined); }, 2000); }),
+      ]);
+      lines.push(`Credentials: ${availableCredentials === undefined ? "check timed out" : availableCredentials.some(model => model.id === "jev-latest") ? "Pi/environment credentials available (acceptance checked on next route)" : "missing Pi/environment credentials"}`);
+    } catch {
+      lines.push("Credentials: availability check failed");
+    } finally { clearTimeout(timer); }
+  }
+  lines.push("", "Configured profiles:");
+  if (config) {
+    for (const profile of config.models) {
+      lines.push(`${profile.model} | thinking: ${profile.thinkingLevel} | ${available.has(profile.model) ? "eligible" : "unavailable or excluded by scope"}`, `  ${profile.description}`);
+    }
+  } else lines.push("None. Every profile requires model, description and thinkingLevel.");
+  lines.push("", "Recent retained agents (latest 10; includes nested/workflow agents):");
+  const recent = [...records].filter(record => record.routing).sort((a, b) => b.startedAt - a.startedAt).slice(0, 10);
+  if (!recent.length) lines.push("No routing decisions yet. Start a fresh subagent; resumed agents do not reroute.");
+  for (const record of recent) {
+    const route = record.routing!;
+    lines.push(`${new Date(record.startedAt).toISOString()} | ${record.id} | ${record.status}`,
+      `  Mode: ${route.mode} | Source: ${route.source} | Result: ${route.code}`,
+      `  ${route.reason}`);
+    if (route.model) lines.push(`  Selected: ${route.model} | requested thinking: ${route.thinkingLevel ?? "inherited"}`);
+    if (route.suggestedModel) lines.push(`  Shadow suggestion: ${route.suggestedModel} | thinking: ${route.suggestedThinkingLevel ?? "inherited"}`);
+    if (record.invocation?.modelId) lines.push(`  Actual: ${record.invocation.modelId} | effective thinking: ${record.invocation.thinking ?? "unknown"}`);
+    if (route.confidence !== undefined) lines.push(`  Confidence: ${(route.confidence * 100).toFixed(1)}%`);
+    if (record.routingUsage) lines.push(`  Classifier tokens: ${record.routingUsage.totalTokens} | ${route.unpriced ? "price unavailable" : `reported cost: $${record.routingUsage.cost.total}`}`);
+  }
+  lines.push("", "Snapshot only. Refresh to reload settings and retained decisions. Opening this page does not classify a task.");
+  const text = lines.join("\n");
+  return apiKey ? text.replaceAll(apiKey, "[redacted]") : text;
+}
+
+export async function showRoutingStatus(ctx: ExtensionCommandContext, records: () => AgentRecord[]): Promise<void> {
+  let refresh = true;
+  while (refresh) {
+    const content = await routingStatusText(ctx, records());
+    refresh = await ctx.ui.custom<boolean>((tui, _theme, _kb, done) => {
+      let offset = 0;
+      let maxOffset = 0;
+      return {
+        render(width: number) {
+          const rows = new Text(content, 0, 0).render(width);
+          const height = Math.max(1, tui.terminal.rows - 6);
+          maxOffset = Math.max(0, rows.length - height);
+          offset = Math.min(offset, maxOffset);
+          return [...new Text("Routing runtime status | Up/Down: scroll | r: refresh | Esc: back", 0, 0).render(width), ...rows.slice(offset, offset + height)];
+        },
+        invalidate() {},
+        handleInput(data: string) {
+          if (matchesKey(data, "escape") || matchesKey(data, "q")) { done(false); return; }
+          if (matchesKey(data, "r")) { done(true); return; }
+          if (matchesKey(data, "up")) offset = Math.max(0, offset - 1);
+          if (matchesKey(data, "down")) offset = Math.min(maxOffset, offset + 1);
+          tui.requestRender();
+        },
+      };
+    });
+  }
+}