ur-agent 1.81.10 → 1.82.1

package/docs/CONFIGURATION.md

@@ -74,7 +74,7 @@ UR-Nexus supports official provider access paths only:
 
 - Explicit API providers: OpenAI, Anthropic, Gemini, OpenRouter, and
   OpenAI-compatible endpoints.
-- Local/server providers: Ollama, LM Studio, llama.cpp, and vLLM OpenAI-compatible
+- Local/server providers: Ollama, LM Studio, llama.cpp, vLLM, and Unsloth OpenAI-compatible
   server mode.
 - Subscription CLI providers: Codex CLI, Claude Code CLI, Gemini CLI, and
   Antigravity where officially supported. These dispatch turns through the
@@ -117,6 +117,7 @@ ur config set provider anthropic-api
 ur config set provider gemini-api
 ur config set provider openrouter
 ur config set provider openai-compatible
+ur config set provider unsloth
 ur provider doctor agy
 ur config set provider.fallback ollama
 ur config set model <model>
@@ -130,7 +131,7 @@ recovery command; changing providers remains an explicit user action.
 
 Provider values accept canonical IDs and common aliases. Examples:
 `openai-api`, `anthropic-api`, `gemini-api`, `openrouter`, `ollama`,
-`lmstudio`, `LM Studio`, `llama.cpp`, `vllm`, and the subscription CLI
+`lmstudio`, `LM Studio`, `llama.cpp`, `vllm`, `unsloth` (`Unsloth Studio`), and the subscription CLI
 providers `codex-cli` (`chatgpt`), `claude-code-cli` (`claude`), `gemini-cli`
 (`gemini`), and `antigravity-cli` (`agy`). Values with spaces should be quoted
 in shell commands.
@@ -179,8 +180,16 @@ OPENAI_COMPATIBLE_API_KEY=...
 ANTHROPIC_API_KEY=...
 GEMINI_API_KEY=...
 OPENROUTER_API_KEY=...
+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
+function calls continue through UR's own permission, sandbox, and verifier
+flow, while Unsloth's server-side tools remain disabled.
+
 ### OpenAI Responses transport
 
 OpenAI uses Chat Completions unless the Responses transport is selected

package/docs/TROUBLESHOOTING.md

@@ -198,10 +198,29 @@ ur provider doctor <provider-id>
 ```sh
 curl http://localhost:11434/api/tags        # Ollama
 curl http://localhost:1234/v1/models        # LM Studio (llama.cpp: 8080, vLLM: 8000)
+curl -H "Authorization: Bearer $UNSLOTH_API_KEY" http://localhost:8888/v1/models
 ur connect openai-api                       # store an API key securely
 ur provider doctor
 ```
 
+### Unsloth is selected but unavailable
+
+- Likely cause: Studio is not running, no model is loaded, its generated API
+  key is not connected, or `base_url` does not end at the compatible API root.
+- Fix: start/load Unsloth outside UR, connect its key, and inspect discovery.
+
+```sh
+echo "$UNSLOTH_API_KEY" | ur connect unsloth
+ur config set provider unsloth
+ur config set base_url http://localhost:8888/v1
+ur provider doctor unsloth
+ur provider models unsloth --json
+```
+
+UR does not start or manage Unsloth. It also disables Unsloth server-side tools
+on every request; tool execution shown by UR is handled by UR's own guarded
+tool loop.
+
 ### Local server unreachable
 
 - Likely cause: wrong `base_url` or the server is not running.

package/docs/USAGE.md

@@ -162,6 +162,7 @@ ur config set provider anthropic-api
 ur config set provider gemini-api
 ur config set provider openrouter
 ur config set provider openai-compatible
+ur config set provider unsloth
 ur config set model <model>
 ur config set base_url <url>
 ur config set provider.fallback ollama
@@ -206,17 +207,20 @@ kind, external CLI usage, native tool/streaming support, and the boundary text.
 
 Provider values accept canonical IDs and common aliases. For example,
 `openai-api`, `anthropic-api`, `gemini-api`, `openrouter`, `ollama`,
-`lmstudio`, `llama.cpp`, and `vllm` are UR-native runtime providers, and
+`lmstudio`, `llama.cpp`, `vllm`, and `unsloth` are UR-native runtime providers, and
 `codex-cli` (`chatgpt`), `claude-code-cli` (`claude`), `gemini-cli` (`gemini`),
 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
-`OPENROUTER_API_KEY`. Subscription CLIs are optional, never required
+`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.
 OpenAI-compatible local or cloud endpoints use `base_url` plus `model`.
+Unsloth defaults to `http://localhost:8888/v1`, requires its Studio API key,
+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.
 
 Use `/model` in an interactive session to select provider first and model
 second. OpenAI API, Claude API, Gemini API, OpenRouter, Ollama, and

package/docs/VALIDATION.md

@@ -19,7 +19,7 @@ You need:
 
 ```sh
 ur --version
-# expected for this release: "1.81.10 (UR-Nexus)"
+# expected for this release: "1.82.1 (UR-Nexus)"
 ```
 
 ### 0.0 Redteam mode and Reverse Skills (1.81.0)

package/docs/providers.md

@@ -41,6 +41,7 @@ multimodal input, external CLI boundary, and sandbox scope:
 | LM Studio | local/server | UR-native | no | yes | yes | yes | UR Bash/File sandbox | `openai-compatible:lmstudio` | local OpenAI-compatible server |
 | llama.cpp | local/server | UR-native | no | yes | yes | yes | UR Bash/File sandbox | `openai-compatible:llama.cpp` | local OpenAI-compatible server |
 | vLLM | local/server | UR-native | no | yes | yes | yes | UR Bash/File sandbox | `openai-compatible:vllm` | OpenAI-compatible server |
+| Unsloth | local/server | UR-native | no | yes | yes | model-dependent | UR Bash/File sandbox | `openai-compatible:unsloth` | authenticated user-run Unsloth Studio endpoint (`UNSLOTH_API_KEY`) |
 | Codex CLI | subscription | subscription-cli | yes | no | no | no† | UR-run tools/output only† | `subscription-cli:codex` | official Codex CLI login |
 | Claude Code | subscription | subscription-cli | yes | no | no | no† | UR-run tools/output only† | `subscription-cli:claude-code` | official Claude Code CLI login |
 | Gemini CLI | subscription | subscription-cli | yes | no | no | no† | UR-run tools/output only† | `subscription-cli:gemini` | official Gemini Code Assist login |
@@ -122,6 +123,7 @@ ur config set provider anthropic-api
 ur config set provider gemini-api
 ur config set provider openrouter
 ur config set provider openai-compatible
+ur config set provider unsloth
 ur config set model <model>
 ur provider select-model <provider> <model> --json
 ur config set base_url <url>
@@ -309,7 +311,7 @@ ur config set provider anthropic-api
 | --- | --- | --- |
 | API providers (openai-api, anthropic-api, gemini-api) | Live discovery from the provider's `/models` endpoint using your connected key (curated fallback until connected) | live |
 | OpenRouter | Fresh `/models` discovery every time its picker opens; no cached-list fallback in the picker | live |
-| Local/server providers (ollama, lmstudio, llama.cpp, vllm) | Dynamic discovery from the selected provider endpoint | live |
+| Local/server providers (ollama, lmstudio, llama.cpp, vllm, unsloth) | Dynamic discovery from the selected provider endpoint | live |
 | OpenAI-compatible | Dynamic discovery from configured endpoint | live |
 | Subscription CLIs (codex-cli, claude-code-cli, gemini-cli, antigravity-cli) | Curated list (the official CLIs expose no models API); first-class in `/model`, dispatched via the official CLI. External CLI behavior depends on the vendor CLI. Log in with `ur auth <provider>` | static |
 
@@ -332,6 +334,7 @@ ur config set provider anthropic-api
 - `lmstudio` — LM Studio OpenAI-compatible server
 - `llama.cpp` — llama.cpp server mode
 - `vllm` — vLLM server
+- `unsloth` — authenticated Unsloth Studio server; UR uses it for inference only
 
 **Important:**
 - A ChatGPT/Claude/Gemini subscription does NOT give API access
@@ -462,6 +465,7 @@ Provider config and doctor commands accept canonical IDs and common aliases:
 | `lmstudio` | `LM Studio`, `lm-studio` |
 | `llama.cpp` | `llama cpp`, `llamacpp`, `llama-cpp` |
 | `vllm` | `vllm server` |
+| `unsloth` | `Unsloth Studio`, `unsloth server`, `unsloth local` |
 
 `ur provider doctor` checks the selected provider. It reports installed/missing
 CLIs, official login status where available, API key presence for API providers,
@@ -496,6 +500,7 @@ OPENAI_COMPATIBLE_API_KEY=...
 ANTHROPIC_API_KEY=...
 GEMINI_API_KEY=...
 OPENROUTER_API_KEY=...
+UNSLOTH_API_KEY=...
 ```
 
 OpenAI-compatible endpoints can point at local or cloud endpoints:
@@ -516,6 +521,32 @@ Local/server providers use their normal endpoints:
 - LM Studio: `http://localhost:1234/v1`
 - llama.cpp server mode: `http://localhost:8080/v1`
 - vLLM server mode: `http://localhost:8000/v1`
+- Unsloth Studio: `http://localhost:8888/v1`
+
+### Unsloth provider-only mode
+
+UR connects to a user-run Unsloth Studio inference server through its official
+OpenAI-compatible API. It does not import the Unsloth Python package, launch or
+update Studio, train or convert models, manage GPUs, or load a model. Start and
+load Unsloth separately, then connect the generated Studio key:
+
+```sh
+ur config set provider unsloth
+echo "$UNSLOTH_API_KEY" | ur connect unsloth
+ur provider doctor unsloth
+ur provider models unsloth --json
+# choose one of the discovered model IDs with /model
+```
+
+The default endpoint is `http://localhost:8888/v1`; override it with
+`ur config set base_url <url>`. Authentication is mandatory. Every Unsloth
+request sets `enable_tools: false`, including streaming requests. The model may
+still return standard OpenAI function calls, but execution remains exclusively
+inside UR's provenance gate, permissions, sandbox, and verifier. This prevents
+Unsloth Studio's optional server-side web/code tools from becoming a second,
+uncontrolled agent runtime. See the official
+[Unsloth Studio announcement](https://github.com/unslothai/unsloth/discussions/5285)
+and [Unsloth repository](https://github.com/unslothai/unsloth).
 
 Ollama allows up to 15 minutes for response headers so a cold model load or
 large prefill can begin. After headers, local and `:cloud` models use a

package/documentation/index.html

@@ -45,7 +45,7 @@
     <main id="content" class="content">
       <header class="topbar">
         <div>
-          <p class="eyebrow">Version 1.81.10</p>
+          <p class="eyebrow">Version 1.82.1</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>

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

@@ -7,7 +7,7 @@ plugins {
 }
 
 group = "dev.urnexus"
-version = "1.81.10"
+version = "1.82.1"
 
 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.81.10",
+  "version": "1.82.1",
   "publisher": "ur-nexus",
   "engines": {
     "vscode": "^1.92.0"

package/package.json

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