Q
Overview

Changelog

All notable changes to @qverisai/cli are documented here.

The format follows Keep a Changelog, and versions follow Semantic Versioning.

Unreleased#

0.9.0 - 2026-07-23#

Added#

  • Added qveris auth login/status/logout using OAuth Device Authorization Grant, refresh-token rotation, revocation, and operating-system credential storage. Trusted headless hosts can explicitly opt into a user-only unencrypted config fallback. API key authentication remains fully compatible and takes precedence when configured. (#250)
  • Added opt-in server-side projections: qveris discover --view routing [--lang zh|en] and qveris call --respond-with full|summary|fields:<JSONPath,...>. Defaults remain unchanged; clients retry once without a projection only when a legacy service explicitly rejects that optional field as unknown. (#256)
  • Added qveris probe for zero-cost parameter validation and quotes without executing a capability. (#259)

0.8.2 - 2026-07-18#

Changed#

  • Routed authenticated requests through an internal credential-provider boundary while preserving all existing API-key resolution and endpoint-selection behavior. (#226)

0.8.1 - 2026-07-15#

Fixed#

  • Account and pricing recovery hints now follow the resolved API endpoint for the public sites and custom deployments instead of linking to an unrelated site. (#221)

0.8.0 - 2026-07-14#

Changed#

  • Replaced legacy region and API-key-prefix routing with deterministic endpoint selection: --base-url overrides QVERIS_BASE_URL, which overrides the built-in default. Invalid URLs fail before network access, and public CLI output no longer exposes deployment-routing controls. (#204)
  • Raised engines.node to >=18.2.0, aligning every package on the toolkit's minimum-supported Node (the MCP server requires 18.2 for closeAllConnections). (#161)

0.7.0 - 2026-07-09#

Added#

  • Rate-limited (429) and transient (503) responses are retried automatically: the CLI honors Retry-After, otherwise backs off exponentially with jitter, bounded by QVERIS_MAX_RETRIES (default 3; 0 disables). (#144)
  • qveris doctor / qveris init diagnostics: preflight checks (Node version, key, region, connectivity) with actionable hints and exact next commands. (#131)
  • Discover/inspect render why_recommended, standardized capability descriptors, expected_cost, and provider fields from the API. (#102)

0.6.1 - 2026-07-06#

Fixed#

  • Accept object-shaped tool categories in discover/inspect results (legacy string tags still supported). (#97)
  • Hardened the MCP probe and call params/observability paths. (#85)

0.6.0 - 2026-05-19#

Added#

  • qveris init — guided first-call wizard: auth → discover → inspect → call → usage/ledger reconciliation guidance. (#32)
  • qveris mcp configure / qveris mcp validate — generate and validate MCP client configs for Cursor, Claude Desktop, and others. (#33)
  • Generated OpenAPI contract types with drift CI, keeping the CLI aligned with the public API contract. (#48)

Fixed#

  • README examples aligned with actual CLI output. (#35)

0.5.0 - 2026-05-06#

Added#

  • Billing transparency audit surfaces: qveris usage and qveris ledger with context-safe summaries. (#18)
  • Multi-region support (global/China) with key-prefix auto-detection and interactive region selection at login. (#12, #13)
  • Canonical discover / inspect / call naming aligned across CLI and MCP. (#14)

0.3.0 - 2026-04-08#

Added#

  • Gradient welcome/login banners. (#10)

Changed#

  • Batched ANSI spans in banner rendering; CLI install URL corrected across docs.

0.2.0 - 2026-04-04#

Added#

  • China region (qveris.cn) support. (#9)

0.1.0 - 2026-04-04#

Added#

  • Initial release: discover / inspect / call from the terminal against the QVeris API.