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/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 NIM | hosted/server API | UR-native | no | yes | yes | model-dependent | UR Bash/File sandbox | `api:nvidia-nim` | `NVIDIA_API_KEY`; configurable NIM endpoint |
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 NIM can each target a separate compatible gateway using
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 NIM is live-discovery first. UR enriches a discovered model only when
216
- NVIDIA's current model API reference documents that exact model's
217
- `reasoning_effort` values. Documented `none` appears as Minimal and `max`
218
- appears as Ultra while the request preserves NVIDIA's wire values. An unknown
219
- NIM model never inherits an invented graded ladder.
220
- Hosted discovery is also a positive agent-contract intersection: a row in the
221
- mixed NVIDIA `/v1/models` inventory is not sufficient by itself to enter the
222
- ongoing agent picker. Verified dedicated media/VLM endpoints are exposed only
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. Anthropic's premium fast tier remains explicit:
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 NIM and local servers publish
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 NIM, and authenticated compatible
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 NIM, Ollama, OpenRouter, LM Studio, Unsloth, and subscription CLIs use a
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 HTTP 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 NIM use their OpenAI-compatible chat endpoints.
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 NIM | Hosted: live `/models` availability intersected with audited agent contracts, plus a generated official OpenAPI catalog for dedicated one-shot APIs. Configured NIM gateway: its own live `/models` catalog | live agents + official task contracts |
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` — requires `NVIDIA_API_KEY` for build.nvidia.com; endpoint is configurable
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 NIM / build.nvidia.com
702
+ ### NVIDIA Agentic and NVIDIA Special / build.nvidia.com
684
703
 
685
- NVIDIA NIM is a UR-native, OpenAI-compatible provider with live discovery:
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
- The default is `https://integrate.api.nvidia.com/v1`. NVIDIA's authenticated
696
- `/v1/models` response proves current account availability but mixes agents,
697
- utilities, VLMs, and generation functions. UR intersects it with a reviewed
698
- positive agent registry before allowing a model to own the multi-turn tool
699
- loop. It does not intersect the result with NVCF's separate deployment-function
700
- inventory. A custom enterprise or self-hosted NIM remains independent and uses
701
- only that configured gateway's `/models` response.
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
- UR calls `/models` and `/chat/completions`. It counts NVIDIA requests with a
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's dedicated APIs are a separate one-shot surface. `/model` labels them
723
- `ONE-SHOT`, shows each task's real purpose, and keeps the current agent model
724
- when one is selected. UR generates the executable catalog from NVIDIA's
725
- official LLM, retrieval, visual, multimodal, healthcare, route-optimization,
726
- and climate OpenAPI indexes. The current catalog has 92 tasks and routes each
727
- one to its documented endpoint on `integrate.api.nvidia.com`,
728
- `ai.api.nvidia.com`, `health.api.nvidia.com`, `optimize.api.nvidia.com`, or
729
- `climate.api.nvidia.com`.
730
-
731
- `NvidiaNimTask` accepts convenience prompt/image/query/passages fields, or its
732
- `describe` action exposes the exact request schema before an advanced
733
- `payload_json` call. `file_inputs` can bind local files into that payload by
734
- JSON pointer. UR automatically inlines small media or creates an NVIDIA Asset
735
- UUID/reference for larger and asset-based contracts, polls documented
736
- asynchronous responses, and saves binary or large JSON results under
737
- `.ur/artifacts/nvidia/`. It reuses `NVIDIA_API_KEY` and returns text/path
738
- metadata to the enclosing agent. Download-only cards, status routes,
739
- staging-only URLs, broken references, and operations without a documented
740
- public hosted POST endpoint never appear as usable choices.
741
-
742
- `ur provider doctor nvidia-nim` verifies the hosted agent catalog and selected
743
- agent model against live `/v1/models`, and reports the generated task-contract
744
- count. Dedicated API entitlement can be verified only with that task's valid
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 NIM | `NVIDIA_API_KEY`, `NVIDIA_MODEL` | `NVIDIA_BASE_URL` (defaults to `https://integrate.api.nvidia.com/v1`) |
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` |
@@ -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, audited NVIDIA agent discovery plus a generated official OpenAPI catalog for 92 exact one-shot AI/retrieval/health/optimization/climate contracts, provider-only Unsloth inference, optional compatible-gateway keys, 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.',
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',
@@ -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.84.7</p>
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 NIM, 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
+ <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 NIM and compatible API keys</h3>
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 NIM separates ongoing agents from specialized one-shot models. Hosted agent discovery intersects live <code>/v1/models</code> inventory with audited tool-loop contracts. The separately labelled one-shot catalog is generated from NVIDIA's official public OpenAPI indexes and currently covers 92 executable AI, retrieval, health, optimization, and climate contracts. Each entry shows its purpose and routes to its exact documented endpoint with the same stored NVIDIA key; schema validation, NVIDIA Asset upload, asynchronous polling, and binary/large-JSON artifact saving are built in. Download-only, staging-only, broken, and non-executable operations stay hidden, and choosing a 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>
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 NIM, 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>
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>
@@ -7,7 +7,7 @@ plugins {
7
7
  }
8
8
 
9
9
  group = "dev.urnexus"
10
- version = "1.84.7"
10
+ version = "1.85.1"
11
11
 
12
12
  repositories {
13
13
  mavenCentral()
@@ -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.84.7",
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.84.7",
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"