ur-agent 1.84.6 → 1.84.7

package/docs/AGENT_FEATURES.md

@@ -350,7 +350,7 @@ automatically changes the active provider.
 | Clean update checks | `ur upgrade`, `ur update`, `src/cli/update.ts` | Detects development/source checkouts and prints a short pull-or-install message instead of attempting self-mutation. npm-installed builds compare the local version with `ur-agent` on npm and print update, latest, registry failure, and malformed-response states without stale planning text. |
 | Bundled IDE extension install | `extensions/vscode-ur-inline-diffs/`, `src/utils/ide.ts`, `ur ide diff` | Public VS Code install now packages the repo's bundled inline-diffs extension as a local VSIX instead of trying an unpublished marketplace ID. The extension remains local-only and reviews `.ur/ide/diffs` bundles from the current workspace. |
 | Professional clarification dialogs | `AskUserQuestion`, `src/tools/AskUserQuestionTool/AskUserQuestionTool.tsx` | Mandatory for every question with concrete choices; plain text is reserved for genuinely open-ended answers. Prefers 2-8 focused options but preserves larger legitimate menus, infers labels from description-only objects, accepts prompt aliases, deduplicates equivalent labels, safely repairs single suggestions with a neutral rejection choice, and is loaded without ToolSearch preloading. |
-| NVIDIA agent/task split | `nvidiaHostedModels.ts`, `NvidiaNimTask`, `/model` | Positively audits hosted agent contracts and exposes a one-shot model only when the live account catalog returns it and a complete adapter exists (FLUX.1 Schnell, Stable Video Diffusion, or PaliGemma). Task selection shows purpose and never replaces the ongoing agent. |
+| NVIDIA agent/task split | generated NVIDIA OpenAPI catalog, `nvidiaHostedModels.ts`, `NvidiaNimTask`, `/model` | Intersects live chat inventory with positive agent contracts and exposes 92 public hosted one-shot contracts across NVIDIA's AI, retrieval, health, optimization, and climate APIs. Task selection shows purpose, validates the documented schema, supports NVIDIA Assets and asynchronous/binary results, and never replaces the ongoing agent. |
 | Documentation release sync | `README.md`, `docs/`, `documentation/`, `CHANGELOG.md` | Keeps the npm README, static documentation site, provider guide, usage guide, feature ledger, validation runbook, and release notes aligned with current release behavior. |
 
 ## v1.24.0 Additions

package/docs/CONFIGURATION.md

@@ -297,10 +297,12 @@ hosted choices unless the authenticated `/v1/models` endpoint returns them.
 For the hosted service, UR focuses NVIDIA's documented fastest 30B agent model,
 `nvidia/nemotron-3.5-lightning-30b-a3b`, first. Its thinking toggle maps to
 NVIDIA's model-specific `chat_template_kwargs.enable_thinking` field.
-The same key also authorizes the separately labelled one-shot FLUX.1 Schnell,
-Stable Video Diffusion, and PaliGemma adapters. Those use their exact
-`ai.api.nvidia.com` paths, never replace `provider.model`, and write generated
-media under `.ur/artifacts/nvidia/` unless an output path is supplied.
+The same key authorizes the separately labelled one-shot catalog generated from
+NVIDIA's public OpenAPI reference. Its 92 task contracts use the exact
+`integrate.api`, `ai.api`, `health.api`, `optimize.api`, or `climate.api`
+NVIDIA path for each model. They never replace `provider.model`; large inputs
+use NVIDIA Assets and binary or large JSON output is saved under
+`.ur/artifacts/nvidia/` unless an output path is supplied.
 
 Unsloth is an inference-provider integration only. Start Unsloth Studio and
 load the model outside UR, connect its generated key with `ur connect unsloth`,

package/docs/TROUBLESHOOTING.md

@@ -227,17 +227,21 @@ If `chat_models` fails, reconnect a current build.nvidia.com key with
 `ur connect nvidia-nim`. A configured enterprise/self-hosted NIM endpoint is
 validated only against that gateway's own `/models` response.
 
-### An NVIDIA image/video/vision model is missing from `/model`
+### An NVIDIA specialized model is missing from `/model`
 
 - Ongoing models appear only when NVIDIA returns them live and their exact
   documented contract supports UR's multi-turn streaming tool loop.
-- Dedicated models appear only in the `ONE-SHOT` section after UR implements
-  their endpoint, request, response, media constraints, and artifact handling.
-  The current set is FLUX.1 Schnell, Stable Video Diffusion, and PaliGemma.
-- Download-only Build cards and unadapted endpoints are intentionally absent;
-  UR does not present a model that it cannot execute correctly.
-- Stable Video Diffusion's hosted inline-image contract accepts JPEG/PNG files
-  smaller than 200 KB. Compress larger input before retrying.
+- Dedicated models come from UR's generated NVIDIA OpenAPI catalog and appear
+  in the `ONE-SHOT` section without relying on the chat `/v1/models` response.
+  Run `bun run provider:nvidia-catalog` in a source checkout to refresh the
+  checked-in contracts from NVIDIA's current public reference.
+- Download-only cards, status-only routes, staging URLs, broken documentation,
+  and operations without a public hosted POST contract are intentionally absent.
+- UR inlines small supported media and automatically uses NVIDIA's Asset API
+  for larger files or contracts that require an asset UUID/reference.
+- A task-specific entitlement failure removes only that model until `Ctrl+R`;
+  the exact endpoint and documentation link are available through the
+  `NvidiaNimTask` describe action.
 
 ### A provider says the previous answer was empty after successful tool calls
 

package/docs/USAGE.md

@@ -283,15 +283,17 @@ Download-only cards from the Build web catalog are not inserted into the
 hosted picker. NVIDIA's live `nemotron-3.5-lightning-30b-a3b` endpoint is
 focused first as its documented fastest 30B agent model; Left/Right controls
 that model's advertised on/off thinking switch.
-Verified specialized models returned by the connected account appear
-separately as `ONE-SHOT`, with their purpose visible before selection. FLUX.1
-Schnell generates a JPEG from text, Stable Video Diffusion generates an MP4
-from a sub-200-KB JPEG/PNG, and PaliGemma analyzes one image with one prompt.
-Selecting one leaves the ongoing agent unchanged; describe the task normally
-and UR uses `NvidiaNimTask` with the same stored NVIDIA key and exact model
-endpoint. Generated media defaults to `.ur/artifacts/nvidia/`. Other
-download-only, utility, and dedicated models remain hidden until UR has a
-complete executable adapter for their contract.
+Specialized public hosted contracts appear separately as `ONE-SHOT`, with
+their purpose visible before selection. The catalog is generated from
+NVIDIA's official OpenAPI indexes and currently covers 92 task models across
+generation, vision, retrieval, safety, translation, biology, molecular and
+medical inference, optimization, and climate APIs. Selecting one leaves the
+ongoing agent unchanged; describe the task normally and UR uses
+`NvidiaNimTask` with the same stored NVIDIA key and exact model endpoint. For
+advanced schemas the tool can describe required fields before running exact
+JSON and file bindings. Large inputs use NVIDIA Assets; binary or large JSON
+output defaults to `.ur/artifacts/nvidia/`. Download-only and non-executable
+cards remain hidden.
 On the `/model` model screen, `K` adds or replaces a
 provider API key and `E` edits its endpoint. This also makes optional
 authentication practical for generic OpenAI-compatible gateways.

package/docs/VALIDATION.md

@@ -19,7 +19,7 @@ You need:
 
 ```sh
 ur --version
-# expected for this release: "1.84.6 (UR-Nexus)"
+# expected for this release: "1.84.7 (UR-Nexus)"
 ```
 
 ### 0.0 Redteam mode and Reverse Skills (1.81.0)
@@ -267,10 +267,11 @@ contract intersection, selected-model doctor diagnostics, redaction of
 internal NVIDIA account/function IDs, endpoint-scoped runtime invalidation,
 native dispatch, the preferred Lightning endpoint and its model-scoped
 `enable_thinking` switch, documented effort aliases, and no Ultra on an unknown model.
-`nvidiaTaskRuntime.test.ts` verifies the exact FLUX, Stable Video Diffusion,
-and PaliGemma endpoints and payloads; Bearer reuse; async request-ID polling;
-artifact decoding; media constraints; and rejection of every model without an
-implemented adapter. In
+`nvidiaTaskRuntime.test.ts` verifies exact AI, retrieval, and healthcare
+endpoint routing; generated-schema defaults and validation; FLUX, Stable Video
+Diffusion, and PaliGemma conveniences; Bearer reuse; NVIDIA Asset upload and
+cleanup; async request-ID polling; artifact decoding; and rejection of models
+without a generated public hosted contract. In
 `/model`, select `openai-compatible` and verify `K` can
 add or replace its optional key while `E` continues to edit only its endpoint.
 

package/docs/providers.md

@@ -455,7 +455,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 | Live `/models` discovery with an endpoint-scoped five-minute cache; Ctrl+R forces a fresh request with no stale fallback | live/cache |
-| NVIDIA NIM | Hosted: live `/models` availability intersected with audited agent contracts, plus separately labelled one-shot models with implemented adapters. Configured NIM gateway: its own live `/models` catalog | live |
+| 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 |
 | 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 |
@@ -720,30 +720,31 @@ documented Nemotron coding-agent models, UR includes NVIDIA's
 and [NIM endpoint guide](https://docs.nvidia.com/nim/large-language-models/latest/tutorials.html).
 
 NVIDIA's dedicated APIs are a separate one-shot surface. `/model` labels them
-`ONE-SHOT`, shows the task purpose, and keeps the current agent model when one
-is selected. `NvidiaNimTask` currently implements three exact contracts:
-
-- [FLUX.1 Schnell](https://docs.api.nvidia.com/nim/reference/black-forest-labs-flux_1-schnell-infer)
-  → text-to-JPEG at
-  `https://ai.api.nvidia.com/v1/genai/black-forest-labs/flux.1-schnell`.
-- [Stable Video Diffusion](https://docs.api.nvidia.com/nim/reference/stabilityai-stable-video-diffusion-infer)
-  → JPEG/PNG-to-MP4 at
-  `https://ai.api.nvidia.com/v1/genai/stabilityai/stable-video-diffusion`;
-  NVIDIA's inline input contract requires a source smaller than 200 KB.
-- [PaliGemma](https://docs.api.nvidia.com/nim/reference/google-paligemma-infer)
-  → one-image visual analysis at
-  `https://ai.api.nvidia.com/v1/vlm/google/paligemma`.
-
-They reuse `NVIDIA_API_KEY`, poll documented asynchronous responses when
-necessary, save generated files under `.ur/artifacts/nvidia/` by default, and
-return only text/path metadata to the enclosing agent. Unsupported,
-download-only, and unadapted dedicated models never appear as usable choices.
-
-`ur provider doctor nvidia-nim` verifies the hosted catalog and selected model
-against the live `/v1/models` response. If NVIDIA rejects a listed model after
-selection, UR redacts NVIDIA's internal function/account IDs, removes that
-model from the current endpoint-scoped session catalog, and asks the user to
-select another model. `Ctrl+R` explicitly retries discovery.
+`ONE-SHOT`, shows each task's real purpose, and keeps the current agent model
+when one is selected. UR generates the executable catalog from NVIDIA's
+official LLM, retrieval, visual, multimodal, healthcare, route-optimization,
+and climate OpenAPI indexes. The current catalog has 92 tasks and routes each
+one to its documented endpoint on `integrate.api.nvidia.com`,
+`ai.api.nvidia.com`, `health.api.nvidia.com`, `optimize.api.nvidia.com`, or
+`climate.api.nvidia.com`.
+
+`NvidiaNimTask` accepts convenience prompt/image/query/passages fields, or its
+`describe` action exposes the exact request schema before an advanced
+`payload_json` call. `file_inputs` can bind local files into that payload by
+JSON pointer. UR automatically inlines small media or creates an NVIDIA Asset
+UUID/reference for larger and asset-based contracts, polls documented
+asynchronous responses, and saves binary or large JSON results under
+`.ur/artifacts/nvidia/`. It reuses `NVIDIA_API_KEY` and returns text/path
+metadata to the enclosing agent. Download-only cards, status routes,
+staging-only URLs, broken references, and operations without a documented
+public hosted POST endpoint never appear as usable choices.
+
+`ur provider doctor nvidia-nim` verifies the hosted agent catalog and selected
+agent model against live `/v1/models`, and reports the generated task-contract
+count. Dedicated API entitlement can be verified only with that task's valid
+payload. If NVIDIA rejects a listed model after selection, UR redacts internal
+function/account IDs and removes only that endpoint-scoped model until
+`Ctrl+R` explicitly retries discovery.
 
 Local/server providers use their normal endpoints:
 

package/documentation/app.js

@@ -68,7 +68,7 @@ const featureGroups = [
   {
     title: 'Providers and auth',
     tags: ['subscription', 'API', 'local', 'effort', 'status bar'],
-    text: 'UR-native API/local/OpenAI-compatible runtimes, provider-scoped endpoints, audited NVIDIA agent discovery plus exact one-shot image/video/vision adapters, 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.',
+    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.',
     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'],
   },
   {

package/documentation/index.html

@@ -45,7 +45,7 @@
     <main id="content" class="content">
       <header class="topbar">
         <div>
-          <p class="eyebrow">Version 1.84.6</p>
+          <p class="eyebrow">Version 1.84.7</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>
@@ -196,7 +196,7 @@ ur --model kimi-k3:cloud --effort high
 ur config set provider nvidia-nim
 ur config set base_url nvidia-nim https://integrate.api.nvidia.com/v1
 /model  # K API key · E endpoint</code></pre>
-            <p>NVIDIA NIM separates ongoing agents from specialized one-shot models. Hosted agent discovery intersects the live <code>/v1/models</code> inventory with audited tool-loop contracts; download-only, utility, and unadapted models stay hidden. The separately labelled one-shot section shows a model only when the connected account returns it and UR has a complete adapter: FLUX.1 Schnell text-to-image, Stable Video Diffusion image-to-video, and PaliGemma image understanding use their exact documented endpoints and the same stored NVIDIA key. Their purpose appears before selection, generated media is saved under <code>.ur/artifacts/nvidia/</code>, and the ongoing agent never changes. 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>
+            <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>
           </article>
           <article>
             <h3>Portable shell deadlines</h3>

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

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ur-agent",
-  "version": "1.84.6",
+  "version": "1.84.7",
   "description": "UR-Nexus — autonomous engineering workflow engine (plan, execute, test, verify, document, benchmark, reproduce)",
   "type": "module",
   "packageManager": "bun@1.3.14",
@@ -68,6 +68,7 @@
     "benchmark:aider-polyglot": "node scripts/benchmark-external.mjs aider-polyglot",
     "safety:matrix": "bun scripts/generate-safety-matrix.mjs",
     "provider:smoke": "bun scripts/provider-smoke.mjs",
+    "provider:nvidia-catalog": "node scripts/update-nvidia-hosted-catalog.mjs",
     "package:check": "node scripts/package-check.mjs",
     "prepack": "bun run build && bun run release:check"
   },