v1.0.41

Volc CLI v1.0.41

Error reporting

• Errors are now emitted with stable typed codes instead of raw text: for example, model detail lookups report model_not_found (with the model name / version in the message), and "no primary version" cases surface as validation errors that tell you to pass --version.
• Command failures outside the command body (setup, guard, and transport stages) still carry a retrievable trace_id in the error envelope, so support can locate the exact request.
• Residual failures are classified into caller-fixable, permission, and abort categories instead of collapsing into unknown; fallback command failures are attributed to validation with the nearest command context.

Auth

• SSO refresh failures caused by an invalid or revoked grant (invalid_grant) now enter a cooldown instead of retrying aggressively on every command.
• Logged-out / expired SSO sessions are typed as such, with guidance to re-run arkcli auth login, instead of surfacing as opaque token errors.

Helper (ark helper)

• Harness configuration errors are localized and actionable: TOML/JSON/YAML parse failures, unsupported harness or plan combinations, and DSH profile problems (missing profile, invalid scope or name, legacy settings/credentials reset) each produce a specific message instead of a generic failure.

Docs (ark docs)

• Recovery hints are now actionable; copied or continued snapshots are recovered correctly, and body snapshot provenance is preserved.
• Search state and pending authorization state are preserved across documentation steps instead of being dropped.

Skills

• Volc Skills bundle synced to v1.0.41 (26 skills); arkcli-docs recovery references updated.