compshare-cli 0.3.3__tar.gz → 0.3.4__tar.gz

{compshare_cli-0.3.3 → compshare_cli-0.3.4}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: compshare-cli
-Version: 0.3.3
+Version: 0.3.4
 Summary: Command-line client for CompShare GPU compute
 Author: CompShare
 License-Expression: Apache-2.0
@@ -29,13 +29,14 @@ Dynamic: license-file
 
 - 交互式创建实例，实时查询规格、库存和价格
 - 支持批量生命周期操作、等待状态和跨地域查询
+- 支持可断线恢复的远程任务、状态查询和增量日志读取
 - 支持社区/自定义镜像、云盘、团队额度与账单
 - 默认中文帮助，可切换英文；所有命令支持 JSON 输出
 - 可通过 `compshare ask` 查询产品使用和计费知识
 - 可通过 `compshare feedback` 反馈 CLI 问题和建议
 - 基于官方 [`ucloud-sdk-python3`](https://github.com/ucloud/ucloud-sdk-python3)
 
-当前版本：`0.3.3`，要求 Python 3.9 或更高版本。
+当前版本：`0.3.4`，要求 Python 3.9 或更高版本。
 
 ## 安装
 
@@ -86,6 +87,9 @@ compshare config use production
 compshare --profile production instance list
 ```
 
+`config list` 会明确标注当前凭证来自配置文件、环境变量或两者混合；JSON 输出还会分别说明
+公钥和私钥的来源，但不会显示凭证内容。
+
 也可以使用环境变量：
 
 ```bash
@@ -115,6 +119,11 @@ compshare instance stop INSTANCE_1 INSTANCE_2
 compshare instance start INSTANCE_1 INSTANCE_2
 compshare instance wait INSTANCE_1 INSTANCE_2 --state Running
 
+# 设置、查询和延期定时关机
+compshare instance schedule set INSTANCE_ID --at 2h
+compshare instance schedule show INSTANCE_ID
+compshare instance schedule extend INSTANCE_ID --by 1h
+
 # SSH
 compshare instance ssh INSTANCE_ID
 # 默认自动填写 API 返回的密码；需要手动输入时可关闭
@@ -122,7 +131,7 @@ compshare instance ssh INSTANCE_ID --no-auto-password
 # 自动登录后执行远程命令；远程参数用 -- 与 CLI 选项分隔
 compshare instance ssh INSTANCE_ID -- nvidia-smi --query-gpu=name
 compshare instance ssh INSTANCE_ID -- 'cd /workspace && python train.py'
-# Agent/脚本：执行并返回 ok、phase、exit_code、stdout、stderr、error
+# Agent/脚本：在统一 JSON 契约的 data 中返回 phase、exit_code、stdout、stderr
 compshare --json instance ssh INSTANCE_ID -- nvidia-smi
 # 强制刷新或禁用本地 SSH 连接缓存
 compshare instance ssh INSTANCE_ID --refresh
@@ -132,6 +141,12 @@ compshare instance cp INSTANCE_ID ./model.bin :/workspace/model.bin
 compshare instance cp INSTANCE_ID ./dataset :/workspace/dataset
 compshare instance cp INSTANCE_ID :/workspace/result ./result
 
+# 长时间运行的远程任务；提交后立即返回 Job ID
+compshare instance job submit INSTANCE_ID --name build --cwd /workspace/project -- make -j8
+compshare instance job show INSTANCE_ID JOB_ID
+compshare instance job logs INSTANCE_ID JOB_ID --follow
+compshare instance job wait INSTANCE_ID JOB_ID --timeout 300
+
 # 产品问答
 compshare ask "按量实例关机以后，云硬盘还收费吗？"
 ```
@@ -182,6 +197,44 @@ compshare instance create --template training-4090 --cpu 32 --memory 128GiB --ye
 `compshare instance template path` 查看实际路径。模板只保存实例创建参数，不保存 API
 凭证、`--yes`、`--show-sensitive` 或其他执行控制选项。
 
+## 远程任务
+
+`instance ssh INSTANCE_ID -- COMMAND` 适合需要同步获取结果的短命令。安装、编译和计算等
+长任务可通过 `instance job` 在实例上脱离 SSH 运行，本地终端关闭或网络中断不会终止任务：
+
+```bash
+# 普通命令及参数会被安全转义
+compshare instance job submit INSTANCE_ID \
+  --name training \
+  --cwd /workspace/project \
+  -- python train.py --epochs 100
+
+# 管道、重定向等 Shell 语法应显式使用 sh -lc
+compshare instance job submit INSTANCE_ID --name install -- \
+  sh -lc 'apt-get update && apt-get install -y ffmpeg'
+
+compshare instance job list INSTANCE_ID
+compshare instance job show INSTANCE_ID JOB_ID
+compshare instance job logs INSTANCE_ID JOB_ID --tail 200
+compshare instance job logs INSTANCE_ID JOB_ID --follow
+compshare instance job wait INSTANCE_ID JOB_ID --timeout 300
+compshare instance job cancel INSTANCE_ID JOB_ID --yes
+compshare instance job prune INSTANCE_ID --older-than 7d --yes
+```
+
+Agent 可按字节偏移增量读取 stdout 和 stderr；响应中的 `StdoutNextOffset`、
+`StderrNextOffset` 可直接用于下一次请求：
+
+```bash
+compshare --json instance job logs INSTANCE_ID JOB_ID \
+  --stdout-offset 0 --stderr-offset 0 --limit 65536
+```
+
+任务记录遵循 XDG Base Directory 规范，保存在实例 SSH 用户的
+`${XDG_STATE_HOME:-$HOME/.local/state}/compshare/jobs/JOB_ID/`。目录权限为 `0700`，文件权限为
+`0600`。任务可以抵抗本地断线，但实例关机或重启会将未完成任务标记为 `Interrupted`；实例重装
+或删除会移除系统盘上的任务记录和日志，重要产物应写入数据盘或共享存储。
+
 ## 功能入口
 
 ```text
@@ -234,20 +287,15 @@ CLI 支持 Bash、Zsh、Fish 和 PowerShell 命令补全。为当前 Shell 自
 compshare --install-completion
 ```
 
-如需检查、复制或自行加载补全脚本：
-
-```bash
-compshare --show-completion
-```
-
 ## 脚本调用
 
-`--json`、`--profile` 和 `--show-sensitive` 是全局选项，必须放在子命令前：
+`--json`、`--profile` 和 `--show-sensitive` 可以放在命令前，也可以放在常见的子命令参数位置；
+`--` 之后的同名参数始终原样传给远程命令：
 
 ```bash
 compshare --json instance list --status Running --all
-compshare --profile production image list --source community
-compshare --json --show-sensitive instance show uhost-xxxxxxxx
+compshare image list --source community --profile production
+compshare instance show uhost-xxxxxxxx --json --show-sensitive
 ```
 
 JSON 模式不会启动交互向导。生命周期操作可使用 `--wait`、`--no-wait` 和
@@ -256,6 +304,44 @@ JSON 模式不会启动交互向导。生命周期操作可使用 `--wait`、`--
 `instance show` 可使用 `--ip`、`--softwares`、`--spec`、`--disks`、`--billing`、
 `--image` 和 `--status` 聚焦输出一个或多个信息分组；不传这些选项时保持完整摘要。
 
+所有 JSON 命令只输出一个 UTF-8 文档，并使用相同的顶层契约。成功响应如下：
+
+```json
+{
+  "ok": true,
+  "schema_version": "1",
+  "data": {"version": "0.3.4"}
+}
+```
+
+错误响应中的 `code` 稳定且不受语言设置影响，适合 Agent 分支判断；`message` 用于显示，
+接口错误的 Action、RetCode 和请求 ID 放在 `details` 中：
+
+```json
+{
+  "ok": false,
+  "schema_version": "1",
+  "error": {
+    "code": "api_error",
+    "message": "...",
+    "details": {
+      "action": "DescribeCompShareInstance",
+      "ret_code": 171,
+      "request_uuid": "..."
+    }
+  }
+}
+```
+
+列表响应使用 `data.items`，总数、过滤数、偏移量和是否返回全部结果位于 `meta`；列表只返回
+表格对应的摘要字段，完整 README、镜像详情和实例详情应通过相应的 `show` 命令读取。
+API 的 Action、RetCode 和请求 ID 也会移到 `meta`。发生默认脱敏时，
+`meta.redacted_fields` 会列出被替换为 `***` 的 JSON 路径。业务字段本身仍沿用 API 返回的名称、
+类型和单位，本版本不做语义转换。
+
+`--json --version` 和 `--json --help` 同样遵循上述契约；JSON 帮助直接返回命令、参数和子命令
+结构，不输出 Rich 终端表格。
+
 Region 和 Zone 是资源参数，放在对应子命令后：
 
 ```bash
@@ -288,14 +374,16 @@ compshare --lang zh --help
 - `instance ssh` 在支持的交互式终端中通过伪终端自动填写登录密码，不会打印密码或将其放入进程参数。
 - 自动登录会接受首次出现的 SSH 主机密钥；已记录主机的密钥发生变化时仍会拒绝连接。
 - `instance ssh INSTANCE_ID -- COMMAND` 可非交互执行远程命令，透传命令输出和退出码。
-- `--json instance ssh INSTANCE_ID -- COMMAND` 会真实执行命令，并结构化返回退出码、标准输出、标准错误及连接/认证错误阶段。
+- `instance job submit` 使用 `nohup` 和独立进程会话在远端运行长任务，任务状态和日志不依赖
+  本地 CLI 进程；取消任务和清理历史记录需要显式确认。
+- `--json instance ssh INSTANCE_ID -- COMMAND` 会真实执行命令；成功信息位于 `data`，连接或认证失败使用统一的 `error` 对象。
 - `--json` 始终以 UTF-8 字节输出，不依赖 Windows 活动代码页或终端编码。
 - `instance ssh` 默认将 API 返回的 SSH 命令和密码按 profile/实例缓存 1 小时；Windows 使用当前用户的 DPAPI 加密密码，其他平台将缓存文件权限限制为当前用户。可用 `--refresh` 强制更新、`--no-cache` 禁用；重置密码和重装实例会清除对应缓存。
 - 实例创建是异步操作；`instance create` 默认等待到 `Running`，显式使用 `--no-wait` 才会在创建接口返回后立即退出。`instance ssh` 也会默认等待实例运行后再连接。
 - `instance cp INSTANCE_ID SOURCE DESTINATION` 可自动认证并双向复制文件或目录；实例侧路径
   使用 `:/path` 表示。旧的 `instance scp INSTANCE_ID LOCAL_PATH REMOTE_PATH` 上传语法继续兼容。
-- `--json instance cp ...` 会真实执行复制，并返回 `ok`、`phase`、`exit_code`、
-  `stdout`、`stderr` 和 `error`；只有显式使用 `--print` 才仅输出命令。
+- `--json instance cp ...` 会真实执行复制，并在统一契约中返回 `phase`、`exit_code`、
+  `stdout` 和 `stderr`；只有显式使用 `--print` 才仅输出命令。
 - `--show-sensitive` 会恢复这些字段的原始值；请勿在共享终端、CI 日志或 Agent 会话中使用。
 - 删除、关机、重启、重装和改配等操作默认要求输入 `y` 或 `n` 确认；空输入或无效输入
   最多重试三次。JSON 模式不启动确认提示，执行这类操作必须显式使用 `--yes`。

{compshare_cli-0.3.3 → compshare_cli-0.3.4}/README.md

@@ -4,13 +4,14 @@
 
 - 交互式创建实例，实时查询规格、库存和价格
 - 支持批量生命周期操作、等待状态和跨地域查询
+- 支持可断线恢复的远程任务、状态查询和增量日志读取
 - 支持社区/自定义镜像、云盘、团队额度与账单
 - 默认中文帮助，可切换英文；所有命令支持 JSON 输出
 - 可通过 `compshare ask` 查询产品使用和计费知识
 - 可通过 `compshare feedback` 反馈 CLI 问题和建议
 - 基于官方 [`ucloud-sdk-python3`](https://github.com/ucloud/ucloud-sdk-python3)
 
-当前版本：`0.3.3`，要求 Python 3.9 或更高版本。
+当前版本：`0.3.4`，要求 Python 3.9 或更高版本。
 
 ## 安装
 
@@ -61,6 +62,9 @@ compshare config use production
 compshare --profile production instance list
 ```
 
+`config list` 会明确标注当前凭证来自配置文件、环境变量或两者混合；JSON 输出还会分别说明
+公钥和私钥的来源，但不会显示凭证内容。
+
 也可以使用环境变量：
 
 ```bash
@@ -90,6 +94,11 @@ compshare instance stop INSTANCE_1 INSTANCE_2
 compshare instance start INSTANCE_1 INSTANCE_2
 compshare instance wait INSTANCE_1 INSTANCE_2 --state Running
 
+# 设置、查询和延期定时关机
+compshare instance schedule set INSTANCE_ID --at 2h
+compshare instance schedule show INSTANCE_ID
+compshare instance schedule extend INSTANCE_ID --by 1h
+
 # SSH
 compshare instance ssh INSTANCE_ID
 # 默认自动填写 API 返回的密码；需要手动输入时可关闭
@@ -97,7 +106,7 @@ compshare instance ssh INSTANCE_ID --no-auto-password
 # 自动登录后执行远程命令；远程参数用 -- 与 CLI 选项分隔
 compshare instance ssh INSTANCE_ID -- nvidia-smi --query-gpu=name
 compshare instance ssh INSTANCE_ID -- 'cd /workspace && python train.py'
-# Agent/脚本：执行并返回 ok、phase、exit_code、stdout、stderr、error
+# Agent/脚本：在统一 JSON 契约的 data 中返回 phase、exit_code、stdout、stderr
 compshare --json instance ssh INSTANCE_ID -- nvidia-smi
 # 强制刷新或禁用本地 SSH 连接缓存
 compshare instance ssh INSTANCE_ID --refresh
@@ -107,6 +116,12 @@ compshare instance cp INSTANCE_ID ./model.bin :/workspace/model.bin
 compshare instance cp INSTANCE_ID ./dataset :/workspace/dataset
 compshare instance cp INSTANCE_ID :/workspace/result ./result
 
+# 长时间运行的远程任务；提交后立即返回 Job ID
+compshare instance job submit INSTANCE_ID --name build --cwd /workspace/project -- make -j8
+compshare instance job show INSTANCE_ID JOB_ID
+compshare instance job logs INSTANCE_ID JOB_ID --follow
+compshare instance job wait INSTANCE_ID JOB_ID --timeout 300
+
 # 产品问答
 compshare ask "按量实例关机以后，云硬盘还收费吗？"
 ```
@@ -157,6 +172,44 @@ compshare instance create --template training-4090 --cpu 32 --memory 128GiB --ye
 `compshare instance template path` 查看实际路径。模板只保存实例创建参数，不保存 API
 凭证、`--yes`、`--show-sensitive` 或其他执行控制选项。
 
+## 远程任务
+
+`instance ssh INSTANCE_ID -- COMMAND` 适合需要同步获取结果的短命令。安装、编译和计算等
+长任务可通过 `instance job` 在实例上脱离 SSH 运行，本地终端关闭或网络中断不会终止任务：
+
+```bash
+# 普通命令及参数会被安全转义
+compshare instance job submit INSTANCE_ID \
+  --name training \
+  --cwd /workspace/project \
+  -- python train.py --epochs 100
+
+# 管道、重定向等 Shell 语法应显式使用 sh -lc
+compshare instance job submit INSTANCE_ID --name install -- \
+  sh -lc 'apt-get update && apt-get install -y ffmpeg'
+
+compshare instance job list INSTANCE_ID
+compshare instance job show INSTANCE_ID JOB_ID
+compshare instance job logs INSTANCE_ID JOB_ID --tail 200
+compshare instance job logs INSTANCE_ID JOB_ID --follow
+compshare instance job wait INSTANCE_ID JOB_ID --timeout 300
+compshare instance job cancel INSTANCE_ID JOB_ID --yes
+compshare instance job prune INSTANCE_ID --older-than 7d --yes
+```
+
+Agent 可按字节偏移增量读取 stdout 和 stderr；响应中的 `StdoutNextOffset`、
+`StderrNextOffset` 可直接用于下一次请求：
+
+```bash
+compshare --json instance job logs INSTANCE_ID JOB_ID \
+  --stdout-offset 0 --stderr-offset 0 --limit 65536
+```
+
+任务记录遵循 XDG Base Directory 规范，保存在实例 SSH 用户的
+`${XDG_STATE_HOME:-$HOME/.local/state}/compshare/jobs/JOB_ID/`。目录权限为 `0700`，文件权限为
+`0600`。任务可以抵抗本地断线，但实例关机或重启会将未完成任务标记为 `Interrupted`；实例重装
+或删除会移除系统盘上的任务记录和日志，重要产物应写入数据盘或共享存储。
+
 ## 功能入口
 
 ```text
@@ -209,20 +262,15 @@ CLI 支持 Bash、Zsh、Fish 和 PowerShell 命令补全。为当前 Shell 自
 compshare --install-completion
 ```
 
-如需检查、复制或自行加载补全脚本：
-
-```bash
-compshare --show-completion
-```
-
 ## 脚本调用
 
-`--json`、`--profile` 和 `--show-sensitive` 是全局选项，必须放在子命令前：
+`--json`、`--profile` 和 `--show-sensitive` 可以放在命令前，也可以放在常见的子命令参数位置；
+`--` 之后的同名参数始终原样传给远程命令：
 
 ```bash
 compshare --json instance list --status Running --all
-compshare --profile production image list --source community
-compshare --json --show-sensitive instance show uhost-xxxxxxxx
+compshare image list --source community --profile production
+compshare instance show uhost-xxxxxxxx --json --show-sensitive
 ```
 
 JSON 模式不会启动交互向导。生命周期操作可使用 `--wait`、`--no-wait` 和
@@ -231,6 +279,44 @@ JSON 模式不会启动交互向导。生命周期操作可使用 `--wait`、`--
 `instance show` 可使用 `--ip`、`--softwares`、`--spec`、`--disks`、`--billing`、
 `--image` 和 `--status` 聚焦输出一个或多个信息分组；不传这些选项时保持完整摘要。
 
+所有 JSON 命令只输出一个 UTF-8 文档，并使用相同的顶层契约。成功响应如下：
+
+```json
+{
+  "ok": true,
+  "schema_version": "1",
+  "data": {"version": "0.3.4"}
+}
+```
+
+错误响应中的 `code` 稳定且不受语言设置影响，适合 Agent 分支判断；`message` 用于显示，
+接口错误的 Action、RetCode 和请求 ID 放在 `details` 中：
+
+```json
+{
+  "ok": false,
+  "schema_version": "1",
+  "error": {
+    "code": "api_error",
+    "message": "...",
+    "details": {
+      "action": "DescribeCompShareInstance",
+      "ret_code": 171,
+      "request_uuid": "..."
+    }
+  }
+}
+```
+
+列表响应使用 `data.items`，总数、过滤数、偏移量和是否返回全部结果位于 `meta`；列表只返回
+表格对应的摘要字段，完整 README、镜像详情和实例详情应通过相应的 `show` 命令读取。
+API 的 Action、RetCode 和请求 ID 也会移到 `meta`。发生默认脱敏时，
+`meta.redacted_fields` 会列出被替换为 `***` 的 JSON 路径。业务字段本身仍沿用 API 返回的名称、
+类型和单位，本版本不做语义转换。
+
+`--json --version` 和 `--json --help` 同样遵循上述契约；JSON 帮助直接返回命令、参数和子命令
+结构，不输出 Rich 终端表格。
+
 Region 和 Zone 是资源参数，放在对应子命令后：
 
 ```bash
@@ -263,14 +349,16 @@ compshare --lang zh --help
 - `instance ssh` 在支持的交互式终端中通过伪终端自动填写登录密码，不会打印密码或将其放入进程参数。
 - 自动登录会接受首次出现的 SSH 主机密钥；已记录主机的密钥发生变化时仍会拒绝连接。
 - `instance ssh INSTANCE_ID -- COMMAND` 可非交互执行远程命令，透传命令输出和退出码。
-- `--json instance ssh INSTANCE_ID -- COMMAND` 会真实执行命令，并结构化返回退出码、标准输出、标准错误及连接/认证错误阶段。
+- `instance job submit` 使用 `nohup` 和独立进程会话在远端运行长任务，任务状态和日志不依赖
+  本地 CLI 进程；取消任务和清理历史记录需要显式确认。
+- `--json instance ssh INSTANCE_ID -- COMMAND` 会真实执行命令；成功信息位于 `data`，连接或认证失败使用统一的 `error` 对象。
 - `--json` 始终以 UTF-8 字节输出，不依赖 Windows 活动代码页或终端编码。
 - `instance ssh` 默认将 API 返回的 SSH 命令和密码按 profile/实例缓存 1 小时；Windows 使用当前用户的 DPAPI 加密密码，其他平台将缓存文件权限限制为当前用户。可用 `--refresh` 强制更新、`--no-cache` 禁用；重置密码和重装实例会清除对应缓存。
 - 实例创建是异步操作；`instance create` 默认等待到 `Running`，显式使用 `--no-wait` 才会在创建接口返回后立即退出。`instance ssh` 也会默认等待实例运行后再连接。
 - `instance cp INSTANCE_ID SOURCE DESTINATION` 可自动认证并双向复制文件或目录；实例侧路径
   使用 `:/path` 表示。旧的 `instance scp INSTANCE_ID LOCAL_PATH REMOTE_PATH` 上传语法继续兼容。
-- `--json instance cp ...` 会真实执行复制，并返回 `ok`、`phase`、`exit_code`、
-  `stdout`、`stderr` 和 `error`；只有显式使用 `--print` 才仅输出命令。
+- `--json instance cp ...` 会真实执行复制，并在统一契约中返回 `phase`、`exit_code`、
+  `stdout` 和 `stderr`；只有显式使用 `--print` 才仅输出命令。
 - `--show-sensitive` 会恢复这些字段的原始值；请勿在共享终端、CI 日志或 Agent 会话中使用。
 - 删除、关机、重启、重装和改配等操作默认要求输入 `y` 或 `n` 确认；空输入或无效输入
   最多重试三次。JSON 模式不启动确认提示，执行这类操作必须显式使用 `--yes`。

{compshare_cli-0.3.3 → compshare_cli-0.3.4}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "compshare-cli"
-version = "0.3.3"
+dynamic = ["version"]
 description = "Command-line client for CompShare GPU compute"
 readme = "README.md"
 requires-python = ">=3.9"
@@ -39,6 +39,9 @@ dev = [
 compshare = "compshare_cli.cli:main"
 compshare-ssh-askpass = "compshare_cli.ssh:askpass"
 
+[tool.setuptools.dynamic]
+version = { attr = "compshare_cli.__version__" }
+
 [tool.setuptools.packages.find]
 where = ["src"]
 

{compshare_cli-0.3.3 → compshare_cli-0.3.4}/src/compshare_cli/__init__.py

@@ -1,3 +1,3 @@
 """CompShare command-line client."""
 
-__version__ = "0.3.3"
+__version__ = "0.3.4"

{compshare_cli-0.3.3 → compshare_cli-0.3.4}/src/compshare_cli/api.py

@@ -52,11 +52,12 @@ def invoke(
                     continue
                 raise
     except CLIError as error:
-        renderer.error(str(error))
+        renderer.coded_error("configuration_error", str(error))
         raise typer.Exit(1) from error
     except ucloud_exc.RetCodeException as error:
         hint = error_hint(error.action or action, error.code)
-        renderer.error(
+        renderer.coded_error(
+            "api_error",
             _with_hint(error.message or str(error), hint),
             details={
                 "action": error.action,
@@ -67,10 +68,10 @@ def invoke(
         )
         raise typer.Exit(1) from error
     except ucloud_exc.UCloudException as error:
-        renderer.error(str(error))
+        renderer.coded_error("transport_error", str(error))
         raise typer.Exit(1) from error
     except Exception as error:  # SDK transport exceptions are not all UCloudException subclasses.
-        renderer.error(str(error))
+        renderer.coded_error("transport_error", str(error))
         raise typer.Exit(1) from error
 
     if success:
@@ -79,7 +80,7 @@ def invoke(
         renderer.data(response)
     else:
         rows = row_builder(response) if row_builder else response.get(list_key or "") or []
-        renderer.data(response, rows=rows, columns=columns)
+        renderer.data(response, rows=rows, columns=columns, json_list=True)
     return response
 
 
@@ -88,11 +89,14 @@ def call(runtime: Runtime, action: str, params: Dict[str, Any]) -> Dict[str, Any
     try:
         return _sdk(runtime, params).invoke(action, params)
     except CLIError as error:
-        Renderer(runtime.json_output, runtime.show_sensitive).error(str(error))
+        Renderer(runtime.json_output, runtime.show_sensitive).coded_error(
+            "configuration_error", str(error)
+        )
         raise typer.Exit(1) from error
     except ucloud_exc.RetCodeException as error:
         hint = error_hint(error.action or action, error.code)
-        Renderer(runtime.json_output, runtime.show_sensitive).error(
+        Renderer(runtime.json_output, runtime.show_sensitive).coded_error(
+            "api_error",
             _with_hint(error.message or str(error), hint),
             details={
                 "action": error.action,
@@ -103,10 +107,14 @@ def call(runtime: Runtime, action: str, params: Dict[str, Any]) -> Dict[str, Any
         )
         raise typer.Exit(1) from error
     except ucloud_exc.UCloudException as error:
-        Renderer(runtime.json_output, runtime.show_sensitive).error(str(error))
+        Renderer(runtime.json_output, runtime.show_sensitive).coded_error(
+            "transport_error", str(error)
+        )
         raise typer.Exit(1) from error
     except Exception as error:
-        Renderer(runtime.json_output, runtime.show_sensitive).error(str(error))
+        Renderer(runtime.json_output, runtime.show_sensitive).coded_error(
+            "transport_error", str(error)
+        )
         raise typer.Exit(1) from error
 
 
@@ -195,11 +203,14 @@ def download_file(
     try:
         return _sdk(runtime, params).download(action, params)
     except CLIError as error:
-        Renderer(runtime.json_output, runtime.show_sensitive).error(str(error))
+        Renderer(runtime.json_output, runtime.show_sensitive).coded_error(
+            "configuration_error", str(error)
+        )
         raise typer.Exit(1) from error
     except ucloud_exc.RetCodeException as error:
         hint = error_hint(error.action or action, error.code)
-        Renderer(runtime.json_output, runtime.show_sensitive).error(
+        Renderer(runtime.json_output, runtime.show_sensitive).coded_error(
+            "api_error",
             _with_hint(error.message or str(error), hint),
             details={
                 "action": error.action or action,
@@ -210,10 +221,14 @@ def download_file(
         )
         raise typer.Exit(1) from error
     except ucloud_exc.UCloudException as error:
-        Renderer(runtime.json_output, runtime.show_sensitive).error(str(error))
+        Renderer(runtime.json_output, runtime.show_sensitive).coded_error(
+            "transport_error", str(error)
+        )
         raise typer.Exit(1) from error
     except Exception as error:
-        Renderer(runtime.json_output, runtime.show_sensitive).error(str(error))
+        Renderer(runtime.json_output, runtime.show_sensitive).coded_error(
+            "transport_error", str(error)
+        )
         raise typer.Exit(1) from error