ur-agent 1.84.7 → 1.85.1
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/CHANGELOG.md +49 -0
- package/README.md +53 -30
- package/dist/cli.js +134953 -120802
- package/docs/AGENT_FEATURES.md +1 -1
- package/docs/AGENT_TRENDS.md +2 -2
- package/docs/CONFIGURATION.md +44 -20
- package/docs/TROUBLESHOOTING.md +46 -18
- package/docs/USAGE.md +37 -23
- package/docs/VALIDATION.md +23 -13
- package/docs/providers.md +77 -62
- package/documentation/app.js +2 -2
- package/documentation/index.html +7 -5
- package/extensions/jetbrains-ur/build.gradle.kts +1 -1
- package/extensions/vscode-ur-inline-diffs/package.json +1 -1
- package/package.json +3 -1
package/docs/providers.md
CHANGED
|
@@ -34,10 +34,11 @@ multimodal input, external CLI boundary, and sandbox scope:
|
|
|
34
34
|
| --- | --- | --- | --- | --- | --- | --- | --- | --- | --- |
|
|
35
35
|
| Subscription | subscription | subscription-placeholder | no | no | no | n/a | n/a (no runtime) | `subscription:unconfigured` | independent subscription runtime only |
|
|
36
36
|
| OpenAI API | API | UR-native | no | yes | yes | yes | UR Bash/File sandbox | `api:openai` | `OPENAI_API_KEY` |
|
|
37
|
-
| Claude API | API | UR-native | no | yes | yes | yes | UR Bash/File sandbox | `api:anthropic` | `ANTHROPIC_API_KEY` |
|
|
37
|
+
| Claude API | API | UR-native | no | yes | yes | yes | UR Bash/File sandbox | `api:anthropic` | `ANTHROPIC_API_KEY`; identity-linked keys also select `ANTHROPIC_WORKSPACE_ID` |
|
|
38
38
|
| Gemini API | API | UR-native | no | yes | yes | yes | UR Bash/File sandbox | `api:gemini` | `GEMINI_API_KEY` |
|
|
39
39
|
| OpenRouter | API/router | UR-native | no | yes | yes | yes | UR Bash/File sandbox | `api:openrouter` | `OPENROUTER_API_KEY` |
|
|
40
|
-
| NVIDIA
|
|
40
|
+
| NVIDIA Agentic | hosted/server API | UR-native | no | yes | yes | model-dependent | UR Bash/File sandbox | `api:nvidia-nim` | `NVIDIA_API_KEY`; public per-card endpoints or configurable NIM gateway |
|
|
41
|
+
| NVIDIA Special | hosted/focused-task API | UR-native | no | task-specific | task-specific | task-specific | UR tool permission flow | `api:nvidia-special` | shared `NVIDIA_API_KEY`; exact HTTP/NVCF/gRPC contracts |
|
|
41
42
|
| OpenAI-compatible | server/API | UR-native | no | yes | yes | endpoint-dependent | UR Bash/File sandbox | `openai-compatible` | optional `OPENAI_COMPATIBLE_API_KEY`; never reuses `OPENAI_API_KEY` |
|
|
42
43
|
| Ollama | local/server | UR-native | no | yes | yes | yes* | UR Bash/File sandbox | `ollama` | configured local, LAN, or hosted endpoint; optional `OLLAMA_API_KEY` |
|
|
43
44
|
| LM Studio | local/server | UR-native | no | yes | yes | yes | UR Bash/File sandbox | `openai-compatible:lmstudio` | configured endpoint; optional `LMSTUDIO_API_KEY` |
|
|
@@ -161,7 +162,7 @@ migrated to the previously active provider on the first provider switch or
|
|
|
161
162
|
scoped base-URL write.
|
|
162
163
|
|
|
163
164
|
The override is not limited to local runtimes. OpenAI API, Anthropic API,
|
|
164
|
-
Gemini API, OpenRouter, and NVIDIA
|
|
165
|
+
Gemini API, OpenRouter, and NVIDIA Agentic can each target a separate compatible gateway using
|
|
165
166
|
the same command. Their official URLs are defaults, not hardcoded dispatch
|
|
166
167
|
destinations; model discovery and inference use the selected provider's saved
|
|
167
168
|
URL. Subscription CLI providers remain vendor-managed and do not accept a base
|
|
@@ -172,6 +173,8 @@ explicit opt-in to the native Responses adapter; it defaults to `store=false`
|
|
|
172
173
|
and supports semantic streaming, background polling/cancellation, WebSocket
|
|
173
174
|
continuation, server compaction, and deferred tool search. It does not change
|
|
174
175
|
OpenAI-compatible, OpenRouter, local, or subscription-CLI providers.
|
|
176
|
+
Both transports fail immediately for machine-readable permanent account or
|
|
177
|
+
billing 429s; ordinary transient rate limits still honor provider retry timing.
|
|
175
178
|
|
|
176
179
|
## Provider-scoped model selection
|
|
177
180
|
|
|
@@ -212,15 +215,14 @@ or has unknown capability metadata. Arbitrary
|
|
|
212
215
|
labels such as `deep` still require an explicit provider alias because UR
|
|
213
216
|
cannot infer their rank.
|
|
214
217
|
|
|
215
|
-
NVIDIA
|
|
216
|
-
NVIDIA's
|
|
217
|
-
|
|
218
|
-
appears as
|
|
219
|
-
|
|
220
|
-
|
|
221
|
-
|
|
222
|
-
|
|
223
|
-
as one-shot task contracts and cannot pass provider/model validation.
|
|
218
|
+
Public NVIDIA Agentic discovery comes from current Build Free Endpoint cards
|
|
219
|
+
that advertise agent/tool use. NVIDIA's account inventory can enrich but never
|
|
220
|
+
filter or remove those models. UR applies only model-specific documented
|
|
221
|
+
reasoning ladders: `none` appears as Minimal and a documented `max` can map to
|
|
222
|
+
Ultra while preserving NVIDIA's wire value. Unknown models never inherit a
|
|
223
|
+
ladder. Focused media, analysis, embedding, safety, translation, and gRPC
|
|
224
|
+
contracts are isolated in NVIDIA Special and cannot pass ongoing-agent model
|
|
225
|
+
validation.
|
|
224
226
|
|
|
225
227
|
For an unknown or newly released model, UR waits for provider-authored model
|
|
226
228
|
metadata or a supported model-scoped probe before adding thinking parameters.
|
|
@@ -281,7 +283,18 @@ remain authoritative. See OpenRouter's
|
|
|
281
283
|
Direct Anthropic requests retain supported prompt-cache breakpoints and enable
|
|
282
284
|
per-tool `eager_input_streaming` on streaming turns. This reduces repeated
|
|
283
285
|
prefill work and avoids waiting for a complete large tool argument before its
|
|
284
|
-
deltas arrive.
|
|
286
|
+
deltas arrive.
|
|
287
|
+
|
|
288
|
+
Identity-linked Anthropic keys additionally need a workspace selection. UR
|
|
289
|
+
accepts `provider.anthropic.workspaceId` through
|
|
290
|
+
`ur config set anthropic.workspace_id wrkspc_...` or
|
|
291
|
+
`ANTHROPIC_WORKSPACE_ID`, validates the `wrkspc_` resource ID, partitions the
|
|
292
|
+
model cache by workspace, and sends `anthropic-workspace-id` on model
|
|
293
|
+
discovery, doctor, message, streaming, and token-count requests. A provider
|
|
294
|
+
400 that names this requirement is preserved with the exact configuration fix
|
|
295
|
+
instead of being reduced to an unverifiable model-list failure.
|
|
296
|
+
|
|
297
|
+
Anthropic's premium fast tier remains explicit:
|
|
285
298
|
|
|
286
299
|
```sh
|
|
287
300
|
ur config set anthropic.speed fast
|
|
@@ -291,6 +304,8 @@ UR sends `speed: "fast"` with the `fast-mode-2026-02-01` beta only for Claude
|
|
|
291
304
|
Opus 5 and Opus 4.8, and retains `usage.speed` so accounting can distinguish the
|
|
292
305
|
tier actually served. Enabled account access is still required. Unsupported
|
|
293
306
|
models stay on standard speed. See Anthropic's
|
|
307
|
+
[authentication](https://platform.claude.com/docs/en/manage-claude/authentication),
|
|
308
|
+
[workspace management](https://platform.claude.com/docs/en/manage-claude/workspaces),
|
|
294
309
|
[prompt caching](https://platform.claude.com/docs/en/build-with-claude/prompt-caching),
|
|
295
310
|
[fine-grained tool streaming](https://platform.claude.com/docs/en/agents-and-tools/tool-use/fine-grained-tool-streaming),
|
|
296
311
|
and [fast mode](https://platform.claude.com/docs/en/build-with-claude/fast-mode).
|
|
@@ -298,10 +313,10 @@ and [fast mode](https://platform.claude.com/docs/en/build-with-claude/fast-mode)
|
|
|
298
313
|
UR uses only provider-documented acceleration controls. OpenAI Responses
|
|
299
314
|
already has native streaming and WebSocket continuation; Gemini 2.5+ implicit
|
|
300
315
|
caching is automatic. Google's Priority tier requires the Interactions API and
|
|
301
|
-
is not a valid `generateContent` option. NVIDIA
|
|
316
|
+
is not a valid `generateContent` option. NVIDIA Agentic and local servers publish
|
|
302
317
|
no universal OpenRouter-style routing field, so UR does not invent one.
|
|
303
318
|
API-key entry for
|
|
304
|
-
OpenAI, Claude, Gemini, OpenRouter, NVIDIA
|
|
319
|
+
OpenAI, Claude, Gemini, OpenRouter, NVIDIA Agentic/Special, and authenticated compatible
|
|
305
320
|
endpoints is a single aligned masked row; the key is stored in the OS keychain
|
|
306
321
|
flow and is never written to settings. On the model screen, `K` adds or
|
|
307
322
|
replaces the selected HTTP provider's key and `E` edits its endpoint. Generic
|
|
@@ -313,7 +328,7 @@ UR uses each provider's non-generating count endpoint when one covers the full
|
|
|
313
328
|
request: OpenAI Responses input tokens, Anthropic Messages token counting,
|
|
314
329
|
Gemini `countTokens`, llama.cpp chat input tokens, and vLLM Messages token
|
|
315
330
|
counting. NVIDIA's hosted NIM API has no documented token-count route;
|
|
316
|
-
NVIDIA
|
|
331
|
+
NVIDIA Agentic, Ollama, OpenRouter, LM Studio, Unsloth, and subscription CLIs use a
|
|
317
332
|
provider-wire local estimate because those runtimes do not share a dependable
|
|
318
333
|
preflight tokenizer for complete chat history plus tools. UR never launches a
|
|
319
334
|
hidden completion for token counting. If a native count call is unavailable,
|
|
@@ -344,7 +359,7 @@ error, not a successful `Did 0 searches` result.
|
|
|
344
359
|
When you select a UR-native provider and model, every agent request is routed
|
|
345
360
|
through that provider's backend:
|
|
346
361
|
|
|
347
|
-
- **API providers** make direct
|
|
362
|
+
- **API providers** make direct calls in each provider's native wire format: Anthropic uses `x-api-key` + `anthropic-version` against `/v1/messages`; OpenAI uses `Authorization: Bearer` against `/v1/chat/completions` by default or `/v1/responses` when explicitly selected; Gemini uses `x-goog-api-key` against `…:generateContent`; OpenRouter and NVIDIA Agentic use documented chat endpoints; NVIDIA Special uses per-card HTTP, NVCF, or gRPC inference.
|
|
348
363
|
- **Local/server providers** connect to the configured local or OpenAI-compatible endpoint (`/v1/chat/completions` for LM Studio, llama.cpp and vLLM; the native tags/chat API for Ollama)
|
|
349
364
|
- **Subscription CLI providers** (Codex CLI, Claude Code, Gemini CLI,
|
|
350
365
|
Antigravity) dispatch the turn through the vendor's official CLI using your
|
|
@@ -455,7 +470,8 @@ ur config set provider anthropic-api
|
|
|
455
470
|
| --- | --- | --- |
|
|
456
471
|
| 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 |
|
|
457
472
|
| OpenRouter | Live `/models` discovery with an endpoint-scoped five-minute cache; Ctrl+R forces a fresh request with no stale fallback | live/cache |
|
|
458
|
-
| NVIDIA
|
|
473
|
+
| NVIDIA Agentic | Public Build: generated per-card agent contracts, never narrowed by account inventory. Configured NIM gateway: its own live `/models` catalog | live card contracts or gateway live |
|
|
474
|
+
| NVIDIA Special | Generated from every current focused Free Endpoint card, including exact HTTP/NVCF/gRPC inference metadata | static generated contracts |
|
|
459
475
|
| Local/server providers (ollama, lmstudio, llama.cpp, vllm, unsloth) | Dynamic discovery from the selected provider endpoint | live |
|
|
460
476
|
| OpenAI-compatible | Dynamic discovery from configured endpoint | live |
|
|
461
477
|
| 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 |
|
|
@@ -479,10 +495,11 @@ provider's successful live catalog remains authoritative for that account.
|
|
|
479
495
|
|
|
480
496
|
**API providers** require environment variable with API key:
|
|
481
497
|
- `openai-api` — requires `OPENAI_API_KEY`
|
|
482
|
-
- `anthropic-api` — requires `ANTHROPIC_API_KEY
|
|
498
|
+
- `anthropic-api` — requires `ANTHROPIC_API_KEY`; identity-linked keys also
|
|
499
|
+
select `ANTHROPIC_WORKSPACE_ID` (or saved `anthropic.workspace_id`)
|
|
483
500
|
- `gemini-api` — requires `GEMINI_API_KEY`
|
|
484
501
|
- `openrouter` — requires `OPENROUTER_API_KEY`
|
|
485
|
-
- `nvidia-nim` —
|
|
502
|
+
- `nvidia-nim` / `nvidia-special` — share `NVIDIA_API_KEY`; Agentic's enterprise endpoint is configurable, while Special routes each public model to its card-specific contract
|
|
486
503
|
|
|
487
504
|
**Local/server providers** require local runtime or endpoint:
|
|
488
505
|
- `ollama` — configurable local, LAN, or hosted Ollama server
|
|
@@ -616,6 +633,7 @@ Provider config and doctor commands accept canonical IDs and common aliases:
|
|
|
616
633
|
| `gemini-api` | `gemini api`, `google gemini api` |
|
|
617
634
|
| `openrouter` | `openrouter api` |
|
|
618
635
|
| `nvidia-nim` | `nvidia`, `NVIDIA Build`, `nvidia api`, `nim` |
|
|
636
|
+
| `nvidia-special` | `NVIDIA Special`, `nvidia task`, `nvidia one-shot` |
|
|
619
637
|
| `openai-compatible` | `compatible`, `openai compatible` |
|
|
620
638
|
| `ollama` | `ollama local` |
|
|
621
639
|
| `lmstudio` | `LM Studio`, `lm-studio` |
|
|
@@ -654,6 +672,7 @@ API providers require explicit user selection and environment keys:
|
|
|
654
672
|
OPENAI_API_KEY=...
|
|
655
673
|
OPENAI_COMPATIBLE_API_KEY=...
|
|
656
674
|
ANTHROPIC_API_KEY=...
|
|
675
|
+
ANTHROPIC_WORKSPACE_ID=wrkspc_... # identity-linked Anthropic keys only
|
|
657
676
|
GEMINI_API_KEY=...
|
|
658
677
|
OPENROUTER_API_KEY=...
|
|
659
678
|
NVIDIA_API_KEY=...
|
|
@@ -680,36 +699,35 @@ The compatible provider's key is optional and provider-scoped. Add or replace
|
|
|
680
699
|
it with `ur connect openai-compatible`, `/connect openai-compatible`, or `K`
|
|
681
700
|
in the `/model` model screen. Anonymous endpoints continue to work without it.
|
|
682
701
|
|
|
683
|
-
### NVIDIA
|
|
702
|
+
### NVIDIA Agentic and NVIDIA Special / build.nvidia.com
|
|
684
703
|
|
|
685
|
-
NVIDIA
|
|
704
|
+
NVIDIA is exposed through two UR-native providers sharing one stored key:
|
|
686
705
|
|
|
687
706
|
```sh
|
|
688
707
|
echo "$NVIDIA_API_KEY" | ur connect nvidia-nim
|
|
689
708
|
ur config set provider nvidia-nim
|
|
690
709
|
ur provider doctor nvidia-nim
|
|
710
|
+
# Focused inference uses the same key:
|
|
711
|
+
ur config set provider nvidia-special
|
|
691
712
|
# Optional self-hosted/enterprise gateway:
|
|
692
713
|
ur config set base_url nvidia-nim https://nim-gateway.example/v1
|
|
693
714
|
```
|
|
694
715
|
|
|
695
|
-
|
|
696
|
-
|
|
697
|
-
|
|
698
|
-
|
|
699
|
-
|
|
700
|
-
|
|
701
|
-
|
|
702
|
-
|
|
703
|
-
The Build web catalog also contains download-only NIMs. UR does not add those
|
|
704
|
-
cards to the hosted picker: only IDs returned by the authenticated hosted
|
|
705
|
-
`/v1/models` endpoint can appear. UR focuses
|
|
716
|
+
NVIDIA Agentic defaults to `https://integrate.api.nvidia.com/v1`. For the
|
|
717
|
+
public service, UR generates its agent catalog from every current Free Endpoint
|
|
718
|
+
card that explicitly advertises agent/tool use. `/v1/models` is not an
|
|
719
|
+
allowlist: account entitlement failures are reported and never remove a model.
|
|
720
|
+
A custom enterprise or self-hosted NIM remains independent and uses only that
|
|
721
|
+
configured gateway's live `/models` response. Download-only cards never enter
|
|
722
|
+
either hosted provider. UR focuses
|
|
706
723
|
`nvidia/nemotron-3.5-lightning-30b-a3b` first because NVIDIA documents it as
|
|
707
724
|
its fastest 30B model for long-running agents. Left/Right can turn that exact
|
|
708
725
|
model's thinking off/on through NVIDIA's documented
|
|
709
726
|
`chat_template_kwargs.enable_thinking`; other NIM models receive only their
|
|
710
727
|
own advertised reasoning contract.
|
|
711
728
|
|
|
712
|
-
|
|
729
|
+
Agentic uses each generated card's documented chat endpoint (or the configured
|
|
730
|
+
gateway). It counts NVIDIA requests with a
|
|
713
731
|
provider-wire local estimate instead of first calling the unsupported hosted
|
|
714
732
|
`/messages/count_tokens` route, and never launches a hidden completion.
|
|
715
733
|
Streaming, standard tool calls, and image input use the
|
|
@@ -719,32 +737,29 @@ documented Nemotron coding-agent models, UR includes NVIDIA's
|
|
|
719
737
|
[NIM LLM API reference](https://docs.api.nvidia.com/nim/reference/llm-apis)
|
|
720
738
|
and [NIM endpoint guide](https://docs.nvidia.com/nim/large-language-models/latest/tutorials.html).
|
|
721
739
|
|
|
722
|
-
NVIDIA
|
|
723
|
-
|
|
724
|
-
|
|
725
|
-
|
|
726
|
-
|
|
727
|
-
|
|
728
|
-
|
|
729
|
-
|
|
730
|
-
|
|
731
|
-
|
|
732
|
-
|
|
733
|
-
`
|
|
734
|
-
|
|
735
|
-
|
|
736
|
-
|
|
737
|
-
|
|
738
|
-
|
|
739
|
-
|
|
740
|
-
|
|
741
|
-
|
|
742
|
-
|
|
743
|
-
|
|
744
|
-
|
|
745
|
-
payload. If NVIDIA rejects a listed model after selection, UR redacts internal
|
|
746
|
-
function/account IDs and removes only that endpoint-scoped model until
|
|
747
|
-
`Ctrl+R` explicitly retries discovery.
|
|
740
|
+
NVIDIA Special is a separate focused-task provider. Selecting a row stores a
|
|
741
|
+
one-shot preference and keeps the current chat provider/model. The generator
|
|
742
|
+
crawls all 100 current Build cards and preserves every card labelled Free
|
|
743
|
+
Endpoint: 36 total, split into 13 Agentic and 23 Special. Thirty-five publish a
|
|
744
|
+
complete executable contract; 22 are Special. The remaining VoiceChat card is
|
|
745
|
+
kept visible with `unpublished` transport because NVIDIA currently provides no
|
|
746
|
+
public request/response protocol.
|
|
747
|
+
|
|
748
|
+
Every executable row records the purpose, input/output hints, exact endpoint,
|
|
749
|
+
HTTP or RPC method, card-specific function ID, request and response schemas,
|
|
750
|
+
documentation, and current NVIDIA availability flag. HTTP cards use their own
|
|
751
|
+
`integrate.api.nvidia.com`, `ai.api.nvidia.com`, or direct
|
|
752
|
+
`{function-id}.invocation.api.nvcf.nvidia.com` route. Five Maxine/Riva cards use
|
|
753
|
+
their exact public service/method on `grpc.nvcf.nvidia.com:443`.
|
|
754
|
+
|
|
755
|
+
`NvidiaSpecial` exposes `describe` for the full contract and `run` for
|
|
756
|
+
convenience text/image/audio/video inputs or exact `payload_json` with
|
|
757
|
+
JSON-pointer file bindings. UR inlines small media, uses NVIDIA Assets for
|
|
758
|
+
larger inputs, polls documented asynchronous requests, decodes single or
|
|
759
|
+
multiple returned artifacts, and saves output under `.ur/artifacts/nvidia/`
|
|
760
|
+
unless the caller supplies a path. Both providers reuse `NVIDIA_API_KEY`.
|
|
761
|
+
NVIDIA availability and entitlement errors are redacted and reported, but no
|
|
762
|
+
model is ever removed from either generated catalog.
|
|
748
763
|
|
|
749
764
|
Local/server providers use their normal endpoints:
|
|
750
765
|
|
|
@@ -802,10 +817,10 @@ Required variables:
|
|
|
802
817
|
| --- | --- | --- |
|
|
803
818
|
| OpenAI-compatible | `OPENAI_COMPATIBLE_BASE_URL`, `OPENAI_COMPATIBLE_MODEL` | `OPENAI_COMPATIBLE_API_KEY` |
|
|
804
819
|
| Unsloth | `UNSLOTH_API_KEY`, `UNSLOTH_MODEL` | `UNSLOTH_BASE_URL` (defaults to `http://localhost:8888/v1`) |
|
|
805
|
-
| NVIDIA
|
|
820
|
+
| NVIDIA Agentic | `NVIDIA_API_KEY`, `NVIDIA_MODEL` | `NVIDIA_BASE_URL` (defaults to `https://integrate.api.nvidia.com/v1`) |
|
|
806
821
|
| OpenAI | `OPENAI_API_KEY`, `OPENAI_MODEL` | `OPENAI_BASE_URL` |
|
|
807
822
|
| OpenRouter | `OPENROUTER_API_KEY`, `OPENROUTER_MODEL` | `OPENROUTER_BASE_URL` |
|
|
808
|
-
| Anthropic | `ANTHROPIC_API_KEY`, `ANTHROPIC_MODEL` | `ANTHROPIC_BASE_URL` |
|
|
823
|
+
| Anthropic | `ANTHROPIC_API_KEY`, `ANTHROPIC_MODEL` | `ANTHROPIC_BASE_URL`; `ANTHROPIC_WORKSPACE_ID` for identity-linked keys |
|
|
809
824
|
| Gemini | `GEMINI_API_KEY`, `GEMINI_MODEL` | `GEMINI_BASE_URL` |
|
|
810
825
|
| Ollama | `OLLAMA_MODEL` | `OLLAMA_BASE_URL` or `OLLAMA_HOST`; `OLLAMA_API_KEY` when required |
|
|
811
826
|
| LM Studio | `LMSTUDIO_BASE_URL`, `LMSTUDIO_MODEL` | `LMSTUDIO_API_KEY` |
|
package/documentation/app.js
CHANGED
|
@@ -68,8 +68,8 @@ const featureGroups = [
|
|
|
68
68
|
{
|
|
69
69
|
title: 'Providers and auth',
|
|
70
70
|
tags: ['subscription', 'API', 'local', 'effort', 'status bar'],
|
|
71
|
-
text: 'UR-native API/local/OpenAI-compatible runtimes, provider-scoped endpoints,
|
|
72
|
-
commands: ['ur provider list', 'ur provider status', 'ur provider doctor nvidia-nim', 'ur connect status', 'ur config set provider nvidia-nim', 'ur config set provider openai-api', 'ur config set provider ollama', 'ur config set base_url llama.cpp http://localhost:9931/v1', '/model', '/effort ultra', '/thinking on'],
|
|
71
|
+
text: 'UR-native API/local/OpenAI-compatible runtimes, provider-scoped endpoints, NVIDIA Agentic plus NVIDIA Special with all 36 current Build Free Endpoint cards and exact per-card HTTP/NVCF/gRPC inference contracts, provider-only Unsloth inference, optional compatible-gateway keys, capability-driven reasoning effort, responsive OpenRouter routing, first-class subscription CLI providers dispatched through official vendor CLIs, provider doctor checks, secure API-key connect, non-secret config, fallback hints, and provider-aware status-bar output.',
|
|
72
|
+
commands: ['ur provider list', 'ur provider status', 'ur provider doctor nvidia-nim', 'ur connect status', 'ur config set provider nvidia-nim', 'ur config set provider nvidia-special', 'ur config set provider openai-api', 'ur config set provider ollama', 'ur config set base_url llama.cpp http://localhost:9931/v1', '/model', '/effort ultra', '/thinking on'],
|
|
73
73
|
},
|
|
74
74
|
{
|
|
75
75
|
title: 'Security and operations',
|
package/documentation/index.html
CHANGED
|
@@ -45,7 +45,7 @@
|
|
|
45
45
|
<main id="content" class="content">
|
|
46
46
|
<header class="topbar">
|
|
47
47
|
<div>
|
|
48
|
-
<p class="eyebrow">Version 1.
|
|
48
|
+
<p class="eyebrow">Version 1.85.1</p>
|
|
49
49
|
<h1>UR-Nexus Documentation</h1>
|
|
50
50
|
<p class="lead">A practical, tutorial-style reference for installing, configuring, automating, extending, and operating UR-Nexus.</p>
|
|
51
51
|
</div>
|
|
@@ -166,6 +166,7 @@ ur provider doctor agy</code></pre>
|
|
|
166
166
|
<pre><code>ur config set provider openai-compatible
|
|
167
167
|
ur config set provider openai-api
|
|
168
168
|
ur config set provider nvidia-nim
|
|
169
|
+
ur config set provider nvidia-special
|
|
169
170
|
ur config set base_url ollama http://localhost:11434
|
|
170
171
|
ur config set base_url llama.cpp http://localhost:9931/v1
|
|
171
172
|
ur config set provider unsloth
|
|
@@ -174,7 +175,7 @@ ur config set provider.fallback ollama
|
|
|
174
175
|
ur config set openai_transport responses
|
|
175
176
|
ur config set responses.store false
|
|
176
177
|
ur config set anthropic.speed fast</code></pre>
|
|
177
|
-
<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, NVIDIA
|
|
178
|
+
<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, NVIDIA Agentic, and API gateways restores the matching address. OpenAI Responses is opt-in and privacy-first; Chat Completions remains the default. Direct Anthropic preserves prompt-cache breakpoints, streams tool inputs with its per-tool control, and enables the documented premium fast tier only when explicitly configured for a supported model. Unsloth is an authenticated inference provider only.</p>
|
|
178
179
|
</article>
|
|
179
180
|
<article>
|
|
180
181
|
<h3>Capability-driven reasoning effort</h3>
|
|
@@ -191,12 +192,13 @@ ur --model kimi-k3:cloud --effort high
|
|
|
191
192
|
<p>The endpoint-scoped model catalog is reused for five minutes, while forced refresh never substitutes stale data. Tool turns preserve OpenRouter Auto Exacto for live throughput and tool-call reliability; non-tool turns prefer end-to-end throughput. Stable session affinity keeps prompt caches warm, while configurable routing preferences and the <code>:nitro</code>, <code>:floor</code>, and <code>:exacto</code> variants remain authoritative.</p>
|
|
192
193
|
</article>
|
|
193
194
|
<article>
|
|
194
|
-
<h3>NVIDIA
|
|
195
|
+
<h3>NVIDIA Agentic, NVIDIA Special, and compatible API keys</h3>
|
|
195
196
|
<pre><code>ur connect nvidia-nim
|
|
196
197
|
ur config set provider nvidia-nim
|
|
198
|
+
ur config set provider nvidia-special
|
|
197
199
|
ur config set base_url nvidia-nim https://integrate.api.nvidia.com/v1
|
|
198
200
|
/model # K API key · E endpoint</code></pre>
|
|
199
|
-
<p>NVIDIA
|
|
201
|
+
<p>NVIDIA is split into NVIDIA Agentic for the ongoing tool loop and NVIDIA Special for focused inference; both share one stored <code>NVIDIA_API_KEY</code>. UR audits all 100 current Build cards and preserves every Free Endpoint card: 13 Agentic and 23 Special. Thirty-five publish executable contracts; the one unpublished protocol stays visible and labelled. Each row shows purpose, input, and output, and uses that card's exact HTTP, direct NVCF, or gRPC endpoint, method, function ID, and request/response schema. NVIDIA Assets, asynchronous polling, five native Maxine/Riva gRPC services, and media/binary/JSON artifact saving are built in. Account errors never remove models, and choosing a Special task never changes the ongoing agent. Nemotron 3.5 Lightning retains its documented on/off thinking field; unknown models inherit no fabricated effort. Generic OpenAI-compatible endpoints can store an optional dedicated key, while anonymous endpoints remain valid.</p>
|
|
200
202
|
</article>
|
|
201
203
|
<article>
|
|
202
204
|
<h3>Portable shell deadlines</h3>
|
|
@@ -207,7 +209,7 @@ ur config set base_url nvidia-nim https://integrate.api.nvidia.com/v1
|
|
|
207
209
|
<article>
|
|
208
210
|
<h3>Tool images across providers</h3>
|
|
209
211
|
<pre><code>Computer screenshot → tool result → vision model</code></pre>
|
|
210
|
-
<p>Every UR-native provider preserves image-bearing tool output in its valid wire shape. OpenRouter, NVIDIA
|
|
212
|
+
<p>Every UR-native provider preserves image-bearing tool output in its valid wire shape. OpenRouter, NVIDIA Agentic, and other Chat-Completions backends keep the tool result textual and send the image in the next multimodal user turn; Gemini, OpenAI Responses, Anthropic, and Ollama use their native rich forms. Vision still depends on the selected model.</p>
|
|
211
213
|
</article>
|
|
212
214
|
<article>
|
|
213
215
|
<h3>Status bar and updates</h3>
|
|
@@ -2,7 +2,7 @@
|
|
|
2
2
|
"name": "ur-inline-diffs",
|
|
3
3
|
"displayName": "UR Inline Diffs",
|
|
4
4
|
"description": "Review, apply, and reject UR inline diff bundles from .ur/ide/diffs inside VS Code.",
|
|
5
|
-
"version": "1.
|
|
5
|
+
"version": "1.85.1",
|
|
6
6
|
"publisher": "ur-nexus",
|
|
7
7
|
"engines": {
|
|
8
8
|
"vscode": "^1.92.0"
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "ur-agent",
|
|
3
|
-
"version": "1.
|
|
3
|
+
"version": "1.85.1",
|
|
4
4
|
"description": "UR-Nexus — autonomous engineering workflow engine (plan, execute, test, verify, document, benchmark, reproduce)",
|
|
5
5
|
"type": "module",
|
|
6
6
|
"packageManager": "bun@1.3.14",
|
|
@@ -86,6 +86,8 @@
|
|
|
86
86
|
"@ag-ui/core": "0.0.57",
|
|
87
87
|
"@ag-ui/encoder": "0.0.57",
|
|
88
88
|
"@anthropic-ai/sandbox-runtime": "0.0.71",
|
|
89
|
+
"@grpc/grpc-js": "^1.14.0",
|
|
90
|
+
"@grpc/proto-loader": "^0.8.0",
|
|
89
91
|
"diff2html": "^3.4.56",
|
|
90
92
|
"playwright-core": "^1.61.1",
|
|
91
93
|
"sharp": "^0.35.3"
|