ur-agent 1.83.0 → 1.83.2

package/docs/AGENT_FEATURES.md

@@ -314,7 +314,7 @@ ur auth antigravity
 ur config set provider ollama
 ur config set provider openai-compatible
 ur config set model qwen2.5-coder:7b
-ur config set base_url http://localhost:11434/v1
+ur config set base_url openai-compatible http://localhost:11434/v1
 ur config set provider.fallback ollama
 ur upgrade
 ```

package/docs/CONFIGURATION.md

@@ -164,7 +164,8 @@ request; Ollama is only used when `ollama` is the selected provider.
 The configured `base_url` is provider-scoped. Setting an address while vLLM is
 active does not replace the saved Ollama, llama.cpp, or Unsloth address;
 returning to any provider restores its own URL. Legacy `provider.baseUrl`
-settings are migrated to the old active provider when the first switch occurs.
+settings are migrated to the old active provider on the first provider switch
+or scoped base-URL write.
 To configure a provider that is not active, use
 `ur config set base_url <provider> <url>`; the success message names the target
 provider. This applies to direct API providers and gateways (OpenAI, Anthropic,
@@ -185,6 +186,12 @@ Ollama and llama.cpp capabilities are loaded lazily for the focused model from
 `/api/show` and `/props`, respectively, so the arrow selector reflects the
 actual model rather than a provider-wide guess.
 
+The effort row contains only capability-backed selectors UR can map to native
+provider values. Ultra appears only when metadata advertises `ultra`, `max`,
+`xhigh`, or an explicit alias; mappings such as `ultra→max` are shown and sent
+exactly. Models that top out at `high`, boolean-thinking models, and unknown
+capabilities omit Ultra. See [Reasoning effort](providers.md#reasoning-effort).
+
 The same provider-first picker is mandatory on the first interactive run in a
 workspace with no model in `.ur/settings.json` or `.ur/settings.local.json`.
 The result is validated and written to the gitignored local settings file.
@@ -223,7 +230,7 @@ UNSLOTH_API_KEY=...
 Unsloth is an inference-provider integration only. Start Unsloth Studio and
 load the model outside UR, connect its generated key with `ur connect unsloth`,
 then select a model discovered from `http://localhost:8888/v1` (or your
-configured `base_url`). UR always sends `enable_tools: false`; standard model
+configured `base_url`). UR sends `enable_tools: false` on every inference request; standard model
 function calls continue through UR's normal native tool flow, while Unsloth's
 server-side tools remain disabled so the integration stays provider-only.
 

package/docs/TROUBLESHOOTING.md

@@ -228,8 +228,8 @@ tool loop.
 - Fix: point UR at the right endpoint.
 
 ```sh
-ur config set base_url http://localhost:11434
-ur provider doctor
+ur config set base_url ollama http://localhost:11434
+ur provider doctor ollama
 ```
 
 Addresses are saved per provider. If the doctor probes an unexpected URL,

package/docs/USAGE.md

@@ -214,7 +214,7 @@ and `antigravity-cli` (`agy`) are subscription CLI providers.
 
 API modes are explicit. Keys are read from a key stored via
 `ur connect <provider>` (OS keychain) or from the environment variables
-`OPENAI_API_KEY`, `ANTHROPIC_API_KEY`, `GEMINI_API_KEY`, and
+`OPENAI_API_KEY`, `ANTHROPIC_API_KEY`, `GEMINI_API_KEY`,
 `OPENROUTER_API_KEY`, and `UNSLOTH_API_KEY`. Subscription CLIs are optional, never required
 dependencies, and never used as a silent fallback. UR-Nexus never scrapes
 browser sessions, extracts OAuth tokens, or bypasses provider restrictions.
@@ -224,9 +224,10 @@ and is inference-only: UR does not manage Unsloth and disables its server-side
 tools while retaining standard function calls inside UR's guarded tool loop.
 
 UR stores `base_url` per provider. You can set different addresses for
-Ollama, llama.cpp, vLLM, and Unsloth once, then switch providers without
-re-entering any of them. `ur config get base_url` always reports the address
-for the currently active provider.
+Ollama, LM Studio, llama.cpp, vLLM, and Unsloth once, then switch providers without
+re-entering any of them. `ur config get base_url` reports the active provider's
+saved scoped override when one exists; use `ur provider status` or
+`ur provider doctor <provider>` to inspect the effective endpoint.
 Use `ur config set base_url <provider> <url>` to change one provider's address
 without making it active first. The `/model` picker offers the same endpoint
 entry flow for a disconnected local/server provider.

package/docs/VALIDATION.md

@@ -19,7 +19,7 @@ You need:
 
 ```sh
 ur --version
-# expected for this release: "1.83.0 (UR-Nexus)"
+# expected for this release: "1.83.2 (UR-Nexus)"
 ```
 
 ### 0.0 Redteam mode and Reverse Skills (1.81.0)
@@ -72,15 +72,17 @@ changes must remain blocked. The deterministic regressions are:
 bun test test/taskListGate.test.ts test/toolExecutionFinalInput.test.ts
 ```
 
-### 0.0.0 OpenRouter research routing and provider UI (1.81.3)
+### 0.0.0 OpenRouter research routing and provider UI (1.81.3; Ultra mapping updated 1.83.1)
 
 Connect OpenRouter, run `/model`, select OpenRouter, and verify that its model
 step shows catalog freshness plus pricing/context/tool/reasoning details. Focus
 a reasoning model and press Left/Right; the displayed effort must change and
-the row must list only that model's provider-advertised levels. Move Up/Down
-between high-only, xhigh, max, and explicitly ultra-capable models; the level list and selected ceiling
-must update immediately, and the confirmation must match `/effort status` and
-the request wire value. For llama.cpp, verify focus requests
+the row must list only capability-backed selectors that map to that model's native levels. Move Up/Down
+between models that top out at high, xhigh, max, and native-ultra models; the level list and
+selected ceiling must update immediately. Models that top out at high must omit Ultra, while
+xhigh/max entries must show `ultra→xhigh` or `ultra→max`, and the
+confirmation must match `/effort status` and the request wire value. For
+llama.cpp, verify focus requests
 `/props?model=<focused-id>` and that a template reporting
 `supports_reasoning_effort: false` has no graded selector. Open the OpenAI API or Claude
 API connection flow and verify the masked `API key` label and entry remain on

package/docs/providers.md

@@ -21,8 +21,9 @@ UR-Nexus never:
 - claims provider support unless the official CLI/API path works
 
 UR-Nexus stores only safe config: provider name, model name, base URL, fallback
-preference, and non-secret preferences. API keys are read from environment
-variables only when the user explicitly selects API mode.
+preference, and non-secret preferences. API keys stay out of plaintext settings
+and are read from the OS keychain after `ur connect` or from environment
+variables when the user explicitly selects API mode.
 
 ## Provider matrix
 
@@ -144,7 +145,8 @@ form `ur config set base_url <provider> <url>` configures a named provider
 without switching first, and the confirmation names that provider. Each
 provider retains its own address across `/provider`, `/model`, and CLI
 switches. The legacy single `provider.baseUrl` field remains readable and is
-migrated to the previously active provider on the first switch.
+migrated to the previously active provider on the first provider switch or
+scoped base-URL write.
 
 The override is not limited to local runtimes. OpenAI API, Anthropic API,
 Gemini API, and OpenRouter can each target a separate compatible gateway using
@@ -171,24 +173,29 @@ the previous provider.
 
 ### Reasoning effort
 
-Use `/effort minimal|low|medium|high|xhigh|max|ultra|auto` inside UR. UR normalizes
-the exact graded levels advertised for the active provider/model pair. `max`
-is provider-neutral and means the selected model's real ceiling: it therefore
-displays and sends `max`, `xhigh`, or `high` according to that model's contract.
+Use `/effort minimal|low|medium|high|xhigh|max|ultra|auto` inside UR. UR builds a
+capability-backed selector set from the native graded levels advertised for the active
+provider/model pair. `max` is provider-neutral and means the selected model's
+highest supported non-Ultra tier: it displays and sends the matching native
+value (commonly `max`, `xhigh`, or `high`) according to that model's contract.
 For OpenRouter, UR preserves the live `/models` reasoning metadata and sends
 the unified `reasoning.effort` request. OpenAI-compatible servers receive the
 resolved value as `reasoning_effort`. The command confirmation, status
 indicator, active-work spinner, SDK settings response, and provider request all
 use the same resolved value. If a provider advertises only boolean thinking,
 UR does not invent a graded effort selector.
-`ultra` is stricter than the provider-neutral `max`: it is selectable and
-accepted only when the provider/model explicitly advertises `ultra`, or when
-live metadata supplies an explicit provider-authored alias and canonical wire
-value. UR never maps unsupported `ultra` to `max`.
+`ultra` is UR's visible beyond-high ceiling selector. It is selectable only
+when the provider/model advertises `ultra`, `max`, `xhigh`, or an explicit
+provider-authored equivalent. UR shows the native mapping (for example,
+`ultra→max`) and sends that exact wire value; it never enables Ultra for a model
+whose graded ladder tops out at `high`, boolean thinking, or unknown capability metadata. Arbitrary
+labels such as `deep` still require an explicit provider alias because UR
+cannot infer their rank.
 
 For Ollama, UR lazily reads the focused model's `/api/show` capabilities and
 sends the selected level through native `think`. Kimi K3 uses
-`low|high|max`; GPT-OSS uses `low|medium|high`; other models advertising
+`low|high|max` and therefore exposes Ultra as `ultra→max`; GPT-OSS uses
+`low|medium|high` and does not expose Ultra; other models advertising
 `thinking` use Ollama's current `low|medium|high|max` contract. Direct OpenAI,
 Anthropic, and Gemini models use curated model-specific ladders from their
 official documentation; live discovery rows are merged with those contracts.
@@ -198,7 +205,7 @@ See [Ollama thinking](https://docs.ollama.com/capabilities/thinking),
 and [Gemini thinking](https://ai.google.dev/gemini-api/docs/thinking).
 
 The provider-first `/model` picker supports the same control directly: use
-Left/Right to move through the effort levels advertised by the focused model,
+Left/Right to move through the capability-backed selectors UR can map to the focused model's native levels,
 then Enter to apply the model and effort together. OpenRouter's live catalog
 shows pricing tier, context size, tool capability, reasoning capability, and
 the full, untruncated model ID immediately below the focused entry. Opening the
@@ -279,12 +286,12 @@ After selecting a provider:
 - Each model shows its concise capabilities; OpenRouter includes pricing,
   context size, tool support, and reasoning support. Its list uses compact
   model names; focus an entry to see the exact provider/model ID
-- Model source is displayed: `live` (dynamic discovery), `cache` (fallback), or `static` (predefined)
-- OpenRouter is fresh-only in this picker: every opening fetches `/models`, and
-  a failed refresh is reported instead of showing stale cached entries
+- Model source is displayed: `live` (dynamic discovery), `cache` (recent endpoint result), or `static` (predefined)
+- OpenRouter reuses an endpoint-scoped `/models` result for five minutes; Ctrl+R
+  forces a live refresh, and a failed forced refresh never substitutes stale data
 - Up/Down changes the focused model and immediately switches to that model's
-  provider-advertised effort list; Left/Right cycles only those exact levels;
-  Enter confirms both
+  capability-backed effort selectors; Left/Right cycles only values UR can map
+  to provider-native levels, and Enter confirms both
 - Press Esc to go back and change provider
 
 **Confirmation**
@@ -587,7 +594,7 @@ ur provider models unsloth --json
 
 The default endpoint is `http://localhost:8888/v1`; override it with
 `ur config set base_url unsloth <url>`. Authentication is mandatory. Every Unsloth
-request sets `enable_tools: false`, including streaming requests. The model may
+inference request sets `enable_tools: false`, including streaming requests. The model may
 still return standard OpenAI function calls; UR handles those through the same
 native tool flow used by its other providers. This keeps Unsloth provider-only
 and avoids running a second tool loop inside Studio. See the official
@@ -617,6 +624,7 @@ Required variables:
 | Provider | Required env vars | Optional env vars |
 | --- | --- | --- |
 | OpenAI-compatible | `OPENAI_COMPATIBLE_BASE_URL`, `OPENAI_COMPATIBLE_MODEL` | `OPENAI_COMPATIBLE_API_KEY` |
+| Unsloth | `UNSLOTH_API_KEY`, `UNSLOTH_MODEL` | `UNSLOTH_BASE_URL` (defaults to `http://localhost:8888/v1`) |
 | OpenAI | `OPENAI_API_KEY`, `OPENAI_MODEL` | `OPENAI_BASE_URL` |
 | OpenRouter | `OPENROUTER_API_KEY`, `OPENROUTER_MODEL` | `OPENROUTER_BASE_URL` |
 | Anthropic | `ANTHROPIC_API_KEY`, `ANTHROPIC_MODEL` | `ANTHROPIC_BASE_URL` |

package/documentation/app.js

@@ -67,9 +67,9 @@ const featureGroups = [
   },
   {
     title: 'Providers and auth',
-    tags: ['subscription', 'API', 'local', 'status bar'],
-    text: 'UR-native API/local/OpenAI-compatible runtimes, first-class subscription CLI providers dispatched through the official vendor CLIs, provider doctor checks, secure API-key connect, non-secret config, fallback hints, and provider-aware status-bar output.',
-    commands: ['ur provider list', 'ur provider status', 'ur provider doctor agy', 'ur connect status', 'ur config set provider openai-api', 'ur config set provider ollama'],
+    tags: ['subscription', 'API', 'local', 'effort', 'status bar'],
+    text: 'UR-native API/local/OpenAI-compatible runtimes, provider-scoped endpoints, provider-only Unsloth inference, capability-driven reasoning effort, responsive OpenRouter routing, first-class subscription CLI providers dispatched through the official vendor CLIs, provider doctor checks, secure API-key connect, non-secret config, fallback hints, and provider-aware status-bar output.',
+    commands: ['ur provider list', 'ur provider status', 'ur provider doctor agy', 'ur connect status', 'ur config set provider openai-api', 'ur config set provider ollama', 'ur config set base_url llama.cpp http://localhost:9931/v1', '/effort ultra'],
   },
   {
     title: 'Security and operations',
@@ -85,7 +85,7 @@ const commands = [
     category: 'Core',
     aliases: [],
     summary: 'Start an interactive session; a fresh workspace must choose and locally persist a validated provider/model pair first.',
-    examples: ['ur', 'ur --model qwen3-coder:480b-cloud', 'ur --continue', 'ur --resume'],
+    examples: ['ur', 'ur --model kimi-k3:cloud --effort ultra', 'ur --continue', 'ur --resume'],
   },
   {
     name: 'ur -p',
@@ -225,7 +225,7 @@ const commands = [
     category: 'Ops',
     aliases: ['settings'],
     summary: 'Open the config panel or persist safe non-secret provider settings.',
-    examples: ['ur config', 'ur config set provider ollama', 'ur config set provider openai-api', 'ur config set provider anthropic-api', 'ur config set model qwen3-coder:480b-cloud', 'ur config set base_url http://localhost:11434/v1', 'ur config set provider.fallback ollama'],
+    examples: ['ur config', 'ur config set provider ollama', 'ur config set provider openai-api', 'ur config set provider anthropic-api', 'ur config set model qwen3-coder:480b-cloud', 'ur config set base_url ollama http://localhost:11434', 'ur config set base_url llama.cpp http://localhost:9931/v1', 'ur config set provider.fallback ollama'],
   },
   {
     name: 'test-first',
@@ -547,8 +547,8 @@ const slashGroups = [
   },
   {
     title: 'Models, tools, and interop',
-    items: ['/model', '/model-doctor', '/model-route', '/escalate', '/mcp', '/plugin', '/skills', '/skill', '/sdk', '/a2a-card'],
-    text: 'Pick models, inspect capabilities, manage MCP/plugin extensions, browse prompt skills with /skills, run executable workflows with /skill, and expose interop surfaces.',
+    items: ['/model', '/provider', '/effort', '/fast', '/model-doctor', '/model-route', '/escalate', '/mcp', '/plugin', '/skills', '/skill', '/sdk', '/a2a-card'],
+    text: 'Pick providers and models, cycle only capability-backed effort selectors that map to provider-native values, inspect capabilities, manage MCP/plugin extensions, browse prompt skills with /skills, run executable workflows with /skill, and expose interop surfaces.',
   },
   {
     title: 'Security operations',

package/documentation/index.html

@@ -45,7 +45,7 @@
     <main id="content" class="content">
       <header class="topbar">
         <div>
-          <p class="eyebrow">Version 1.83.0</p>
+          <p class="eyebrow">Version 1.83.2</p>
           <h1>UR-Nexus Documentation</h1>
           <p class="lead">A practical, tutorial-style reference for installing, configuring, automating, extending, and operating UR-Nexus.</p>
         </div>
@@ -165,16 +165,31 @@ ur provider doctor agy</code></pre>
             <h3>API and local providers</h3>
             <pre><code>ur config set provider openai-compatible
 ur config set provider openai-api
-ur config set base_url http://localhost:11434/v1
+ur config set base_url ollama http://localhost:11434
+ur config set base_url llama.cpp http://localhost:9931/v1
+ur config set provider unsloth
 ur config set model qwen3-coder:480b-cloud
 ur config set provider.fallback ollama
 ur config set openai_transport responses
 ur config set responses.store false</code></pre>
-            <p>API providers require explicit selection and read keys from a key stored via <code>ur connect</code> (OS keychain) or from environment variables. OpenAI Responses is opt-in and privacy-first; Chat Completions remains the default. Local providers include Ollama, LM Studio, llama.cpp, and vLLM.</p>
+            <p>API providers require explicit selection and read keys from a key stored via <code>ur connect</code> (OS keychain) or from environment variables. Each configurable provider keeps its own <code>base_url</code>, so switching among Ollama, LM Studio, llama.cpp, vLLM, Unsloth, and API gateways restores the matching address. OpenAI Responses is opt-in and privacy-first; Chat Completions remains the default. Unsloth is an authenticated inference provider only.</p>
+          </article>
+          <article>
+            <h3>Capability-driven reasoning effort</h3>
+            <pre><code>/effort ultra
+ur --model kimi-k3:cloud --effort high
+/model  # Up/Down model · Left/Right effort · Enter apply</code></pre>
+            <p>The normalized vocabulary is <code>minimal</code>, <code>low</code>, <code>medium</code>, <code>high</code>, <code>xhigh</code>, <code>max</code>, and <code>ultra</code>; <code>/effort auto</code> clears an explicit choice. UR lists only capability-backed selectors it can map to the focused model's provider-native levels. <code>max</code> resolves to the highest supported non-Ultra tier. Ultra appears only for native <code>ultra</code>, advertised <code>max</code>/<code>xhigh</code>, or an explicit provider alias; the picker shows translations such as <code>ultra→max</code> and sends that exact provider value. Models that top out at <code>high</code>, boolean-thinking models, and unknown capabilities do not get Ultra.</p>
+          </article>
+          <article>
+            <h3>OpenRouter responsive routing</h3>
+            <pre><code>ur config set provider openrouter
+/model  # cached catalog; Ctrl+R forces live refresh</code></pre>
+            <p>The endpoint-scoped model catalog is reused for five minutes, while forced refresh never substitutes stale data. Interactive requests prefer OpenRouter latency routing, a stable session ID, and provider-authored prompt-cache markers; explicit routing preferences and model variants still win.</p>
           </article>
           <article>
             <h3>Status bar and updates</h3>
-            <pre><code>Ollama | llama3 | ask | main | update 1.48.0 available</code></pre>
+            <pre><code>Ollama | llama3 | ask | main | update 1.83.2 available</code></pre>
             <p>The interactive status bar shows only important runtime state: provider, model, mode, branch, active tasks, checks status when known, and update availability. It is hidden in CI, dumb terminals, and print mode.</p>
           </article>
           <article>

package/examples/provider_selection.md

@@ -38,7 +38,11 @@ ur config set provider codex-cli
 ```
 
 Inside a session, `/model` gives the same flow interactively: provider first,
-then only that provider's models. Verify the active pair any time:
+then only that provider's models. Use Up/Down to focus a model and Left/Right to
+cycle its capability-backed effort selectors before pressing Enter. Ultra is
+shown only when UR can map it to an advertised native `ultra`, `max`, `xhigh`,
+or explicit alias; the picker displays the exact mapping, such as
+`ultra→max`. Verify the active pair any time:
 
 ```sh
 ur provider status

package/extensions/jetbrains-ur/build.gradle.kts

@@ -7,7 +7,7 @@ plugins {
 }
 
 group = "dev.urnexus"
-version = "1.83.0"
+version = "1.83.2"
 
 repositories {
     mavenCentral()

package/extensions/vscode-ur-inline-diffs/package.json

@@ -2,7 +2,7 @@
   "name": "ur-inline-diffs",
   "displayName": "UR Inline Diffs",
   "description": "Review, apply, and reject UR inline diff bundles from .ur/ide/diffs inside VS Code.",
-  "version": "1.83.0",
+  "version": "1.83.2",
   "publisher": "ur-nexus",
   "engines": {
     "vscode": "^1.92.0"

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ur-agent",
-  "version": "1.83.0",
+  "version": "1.83.2",
   "description": "UR-Nexus — autonomous engineering workflow engine (plan, execute, test, verify, document, benchmark, reproduce)",
   "type": "module",
   "packageManager": "bun@1.3.14",