ur-agent 1.84.4 → 1.84.6

package/CHANGELOG.md

@@ -1,5 +1,67 @@
 # Changelog
 
+## 1.84.6
+
+- Made NVIDIA hosted model selection contract-driven. The authenticated live
+  catalog is now intersected with a reviewed positive list of multi-turn,
+  tool-capable agent contracts, so download-only cards, utility endpoints,
+  single-use functions, and unknown models cannot become the ongoing agent.
+  Custom enterprise/self-hosted NIM gateways continue to use their own saved
+  endpoint and live catalog.
+- Added complete NVIDIA one-shot workflows without replacing the conversation
+  model. `/model` labels eligible FLUX.1 Schnell, Stable Video Diffusion, and
+  PaliGemma entries with their purpose; UR reuses the configured NVIDIA key,
+  dispatches to each exact documented `ai.api.nvidia.com` endpoint, polls
+  asynchronous jobs, and saves JPEG/MP4 artifacts under
+  `.ur/artifacts/nvidia/`. A one-shot entry appears only when the connected
+  account returns it and UR has a complete adapter.
+- Kept NVIDIA media tasks portable across every enclosing agent provider.
+  Generated binary data is decoded locally and the tool result contains only
+  the artifact path or analysis text, avoiding provider-invalid image content
+  inside `tool_result`. Definitive account/function 404s are reported without
+  exposing NVIDIA's internal identifiers and remove the rejected model from
+  the current catalog until refresh.
+- Made structured clarification menus the mandatory path for every real
+  question with concrete choices. Plain text remains available for genuinely
+  open-ended questions, while legitimate menus larger than eight options are
+  preserved instead of failing schema validation. Public, configuration,
+  troubleshooting, validation, and technical documentation now describe the
+  same executable behavior.
+
+## 1.84.5
+
+- Fixed a provider-wide multi-turn tool-history failure. Some
+  OpenAI-compatible models reuse response-scoped IDs such as `TaskCreate:0`;
+  UR previously classified the later completed pair as a duplicate, removed
+  it from the API-bound history, and could prompt the model to say the user's
+  answer was empty. Later unambiguous call/result pairs now receive stable,
+  conversation-unique IDs before pairing repair, while the saved transcript
+  remains unchanged and genuinely corrupt duplicates still fail normally.
+- Restored NVIDIA Build's full hosted chat catalog by making its authenticated
+  `/v1/models` response authoritative. UR no longer intersects hosted models
+  with the unrelated NVCF deployment-function inventory that hid valid
+  endpoints; non-agent utility endpoints remain filtered, and download-only
+  Build cards are never inserted into the hosted picker. Doctor and runtime
+  invalidation now follow the same catalog contract.
+- Reduced NVIDIA request overhead and added exact model-native behavior. Hosted
+  NIM token analysis now uses the local request-shaped estimate immediately
+  instead of probing an unsupported count route. Nemotron 3.5 Lightning is
+  preferred when NVIDIA returns it and its native on/off thinking field is
+  wired; Kimi K3 retains its mandatory documented effort contract, and no
+  unknown model inherits a fabricated level or Ultra.
+- Added documented direct-Anthropic latency controls. Prompt-cache breakpoints
+  now survive native request translation, streaming tools use per-tool
+  fine-grained input streaming, and `anthropic.speed=fast` opts enabled Opus
+  5/4.8 accounts into Anthropic's premium research-preview tier with the
+  required beta header. Unsupported models stay on standard speed and response
+  accounting preserves the tier actually served.
+- Audited other provider acceleration paths against their current APIs.
+  OpenAI Responses already retains native SSE/WebSocket continuation, Gemini
+  implicit caching remains automatic, and UR does not invent Interactions-only
+  Gemini Priority fields or OpenRouter-style routing controls for NVIDIA and
+  local servers. User, troubleshooting, validation, provider, and technical
+  documentation now match these executable boundaries.
+
 ## 1.84.4
 
 - Corrected NVIDIA Build model discovery so the picker no longer treats the

package/README.md

@@ -347,6 +347,19 @@ ur config set openrouter.service_tier priority # auto | default | flex | priorit
 ur config set openrouter.speed fast            # standard | fast
 ```
 
+Direct Anthropic requests automatically preserve UR's prompt-cache
+breakpoints and enable per-tool fine-grained input streaming, reducing repeat
+prefill work and exposing large tool arguments as Claude generates them.
+Anthropic's premium research-preview fast tier is opt-in and is sent only for
+Claude Opus 5 or Opus 4.8:
+
+```sh
+ur config set anthropic.speed fast             # standard | fast
+```
+
+The account must have Anthropic fast-mode access. Unsupported Claude models
+stay on standard speed instead of receiving a fabricated provider option.
+
 Provider config accepts canonical IDs and common aliases. Examples:
 `openai-api`, `anthropic-api`, `gemini-api`, `openrouter`, `nvidia-nim` (`NVIDIA Build`), `ollama`,
 `lmstudio`, `LM Studio`, `llama.cpp`, `vllm`, `unsloth` (`Unsloth Studio`), and the subscription CLIs
@@ -392,19 +405,33 @@ In the interactive app, `/model` is a two-step, provider-first picker:
    `static` (predefined), or `unavailable` after a failed discovery with no
    fallback. Local/server providers (Ollama, LM Studio,
    llama.cpp, vLLM, Unsloth) and OpenAI-compatible endpoints are discovered live. Hosted NVIDIA NIM
-   intersects its broad `/v1/models` response with NVIDIA's authenticated ACTIVE
-   function inventory and removes non-agent utility endpoints before presenting a model; API
+   intersects its authenticated `/v1/models` response with UR's audited positive
+   agent contracts, so presence in NVIDIA's mixed inventory never makes an
+   embedding, parser, VLM, generator, or download-only card an ongoing chat model.
+   The separate NVCF deployment inventory does not narrow the hosted list. API
    providers use live discovery from their `/models` endpoint once a key is
    connected (with a curated fallback list before that). Subscription CLIs show
    their curated model list because the official CLIs expose no models API. The
    generic `subscription` entry is an internal placeholder hidden from listings.
 
+   NVIDIA is split into two visibly labelled modes. `AGENT` models own the
+   ongoing tool-calling conversation. `ONE-SHOT` models run one specialized
+   job and never replace that agent. UR exposes a task model only when the live
+   account catalog returns it and UR has a complete adapter: FLUX.1 Schnell
+   (text-to-image JPEG), Stable Video Diffusion (JPEG/PNG-to-MP4), and PaliGemma
+   (single-image understanding).
+   Focusing a task model shows its purpose and constraints; Enter remembers it
+   for the next matching NVIDIA task. Generated media is written under
+   `.ur/artifacts/nvidia/` by default and the model receives only the file path
+   in the tool result, preserving compatibility with providers that reject
+   binary image content inside `tool_result`.
+
    In the model catalog, use **Up/Down** to browse. For graded models, the effort row updates to
    the focused model's capability-backed selectors; use **Left/Right** to cycle
    only values UR can map to provider-native levels before pressing Enter. For
    models with thinking but no advertised graded ladder on runtimes with a native
-   two-state mapping (currently
-   Ollama and direct Anthropic), Left selects off, Right selects on, and `t`
+   two-state mapping (currently Ollama, direct Anthropic, and NVIDIA Nemotron
+   3.5 Lightning), Left selects off, Right selects on, and `t`
    toggles. The same state is available directly through `/thinking on|off`.
    Generic OpenAI-compatible runtimes never receive an invented boolean field.
    `ultra` is UR's visible
@@ -465,8 +492,11 @@ identity line in the system prompt reflects it too:
   `x-api-key` + `anthropic-version` on `/v1/messages`, OpenAI `Bearer` on
   `/v1/chat/completions` by default or `/v1/responses` when explicitly
   selected, Gemini `x-goog-api-key` on `:generateContent`, OpenRouter on its
-  OpenAI-compatible chat endpoint, and NVIDIA NIM on its official hosted or
-  user-selected OpenAI-compatible endpoint.
+  OpenAI-compatible chat endpoint, and NVIDIA NIM agent models on their exact
+  documented hosted chat endpoint or a user-selected compatible NIM gateway.
+  NVIDIA one-shot models use their documented `ai.api.nvidia.com` endpoint
+  with the same securely stored `NVIDIA_API_KEY`; asynchronous jobs are polled
+  through NVIDIA's request ID until completion or user cancellation.
 - **Local/server** providers call the configured endpoint (`/v1/chat/completions`
   for LM Studio/llama.cpp/vLLM/Unsloth; the native API for Ollama). Unsloth is
   provider-only: UR never starts, installs, updates, trains, or loads models in