@itpay/cli 2.0.5 → 2.0.7

package/docs/cli-reference/commands/services/action.md

@@ -26,17 +26,22 @@ itpay services action <service_execution_id> --action <action_type>
   "status": "candidate_selected",
   "result": {
     "service_execution_id": "<id>",
-    "candidate": { "rank": 2, "title": "<title>" }
+    "candidate": { "rank": 2, "title": "<title>" },
+    "checkout": {
+      "capability_id": "<paid_capability_id>",
+      "price": { "amount_minor": 50, "currency": "CNY" },
+      "delivery_email_required": true
+    }
   },
-  "instruction": "候选已绑定到来源 Execution；后续动作必须继续使用该 Execution。",
-  "next": { "command": "itpay services quote <id> --capability <capability_id> --email <email> --json", "reason": "为已确认候选准备报价" },
+  "instruction": "候选已绑定到当前 Execution，但尚未购买后续服务。现在只向用户说明已选择的候选、后续价格和邮箱用途，然后询问是否购买并停止。用户明确同意并提供邮箱前，不要执行 next.command，不要创建新 Execution 或 Checkout。",
+  "next": { "command": "itpay services checkout <id> --capability <capability_id> --email <email> --json", "reason": "仅在用户明确同意价格并提供真实邮箱后执行" },
   "recovery": [{ "command": "itpay services next <id> --json", "reason": "重新读取服务端允许的动作" }]
 }
 ```
 
-`next` 来自 action 写入后重新读取的类型化 `allowed_actions`，不是 CLI 根据服务名猜测。若后续不是报价，CLI 渲染该动作对应的通用命令；没有合法动作时返回 `next: null`。非候选 action 仍返回 `action_recorded` 并引导 `services next`。
+`next` 来自 action 写入后重新读取的类型化 `allowed_actions`，不是 CLI 根据服务名猜测。普通单 Execution 的付费 continuation 使用 `services checkout`；候选选择本身不代表用户已经同意购买。没有合法动作时返回 `next: null`。非候选 action 仍返回 `action_recorded` 并引导 `services next`。
 
-rank 不存在、属于旧结果集或其他 Execution、action 不允许、status 非法时均不写 action；返回结构化错误并引导同一 Execution 的 `services next`。相同候选重试幂等；同一结果集改选另一个候选返回冲突，不覆盖已批准事实。
+rank 不存在、属于旧结果集或其他 Execution、action 不允许、status 非法时均不写 action；返回结构化错误并且只引导同一 Execution 的 `services next`。不得新建 Execution、重新 invoke 或构造候选 ID。相同候选重试幂等；同一结果集改选另一个候选返回冲突，不覆盖已批准事实。
 
 ## Agent Type / Host
 

package/docs/cli-reference/commands/services/checkout.md

@@ -33,8 +33,8 @@ itpay services checkout <service_execution_id> --resume
     "amount": "<amount> <currency>"
   },
   "handoff": { "url": "<checkout_url>", "qr_local_path": "<host_optional_path>", "markdown": "<host_optional_markdown>" },
-  "instruction": "把二维码和付款链接展示给用户；确认可见前不要查询状态，也不要创建新 Checkout。",
-  "next": { "command": "itpay checkout --id <checkout_id> --token <display_token>", "reason": "跟踪同一笔 Checkout" },
+  "instruction": "把付款链接、可用二维码和金额实际发送给用户，然后停止并等待。不要立即执行 next.command，不要创建第二个 Checkout，不要新建 Execution，不要调用 pay。用户表示已经完成付款或要求查询状态后，只执行 next.command；用户的话本身不是付款成功证明。",
+  "next": { "command": "itpay checkout --id <checkout_id> --token <display_token> --json", "reason": "仅在用户完成付款操作或要求查询后，读取同一 Checkout 的权威状态" },
   "recovery": []
 }
 ```
@@ -79,4 +79,4 @@ itpay services checkout <service_execution_id> --resume
 | `codex-cli` | `handoff={url,qr_local_path}`；普通文本模式在用户可见终端渲染二维码。 |
 | `claude-code-desktop` | `handoff={url,qr_local_path,markdown}`；把 `handoff.markdown` 原样发送到当前桌面对话。 |
 | `claude-code-cli` | `handoff={url,qr_local_path}`；普通文本模式在用户可见终端渲染二维码。 |
-| `workbuddy` | `handoff={url,qr_local_path,qr_image_url}`；发送链接和可用二维码附件，原生行为后续细化。 |
+| `workbuddy` | `handoff={url,qr_local_path,qr_image_url}`；发送可点击链接，优先把本地路径作为图片附件，不能发送本地附件时使用绝对图片 URL；发送金额后停止等待。 |

package/docs/cli-reference/commands/services/invoke.md

@@ -27,7 +27,7 @@ itpay services invoke <service_execution_id> --capability <capability_id>
     "items": [{ "rank": 1, "title": "<title>", "safe_payload": {} }],
     "quota": { "remaining": 2, "limit": 3 }
   },
-  "instruction": "向用户展示编号和 safe_payload；用户选择后只在当前 Execution 提交对应 rank，不要新建 Execution。",
+  "instruction": "向用户展示编号和 safe_payload；若候选列表已满足用户目标，在此停止。仅在用户明确选择并希望继续时，才在当前 Execution 提交对应 rank。",
   "next": { "command": "itpay services action <id> --action <action_type> --actor-type human --status approved --candidate <rank> --json", "reason": "记录用户选择" },
   "recovery": []
 }
@@ -35,7 +35,7 @@ itpay services invoke <service_execution_id> --capability <capability_id>
 
 ## 无结果与额度耗尽
 
-无结果时明确说明 Provider 已返回空结果，并根据服务端 graph 决定重试同一 execution 或启动新 execution。额度耗尽时返回付费 capability 的完整 `services quote` 命令，不要求 CLI 自己识别服务。
+无结果时明确说明 Provider 已返回空结果，并根据服务端 graph 决定重试同一 execution 或启动新 execution。额度耗尽时，普通单 Execution 流程返回完整的 `services checkout` 单项快捷命令；`services quote -> cart add --quote -> buy --cart` 只用于用户明确要求把多个独立 Execution 合并付款的高级流程。
 
 ```json
 {
@@ -51,16 +51,16 @@ itpay services invoke <service_execution_id> --capability <capability_id>
       "delivery_email_required": false
     }
   },
-  "instruction": "免费额度已用完且本次未调用 Provider；先向用户说明价格并确认购买。",
+  "instruction": "免费额度已用完，本次没有调用 Provider，也尚未创建 Quote 或 Checkout。现在只向用户说明：‘继续当前请求需要支付 0.10 CNY，是否购买？’然后停止并等待用户明确回复。用户明确同意前，不要执行 next.command，不要新建 Execution，不要尝试其他 capability、quote、cart、buy、checkout 或 pay 命令。",
   "next": {
-    "command": "itpay services quote <id> --capability <paid_capability_id> --input <key=value> --json",
-    "reason": "准备当前服务的付费 continuation 报价"
+    "command": "itpay services checkout <id> --capability <paid_capability_id> --input <key=value> --json",
+    "reason": "仅在用户明确同意支付 0.10 CNY 后执行；否则停止"
   },
   "recovery": []
 }
 ```
 
-缺少 required input 时返回 `capability_input_invalid`，recovery 给出带占位符的同一 invoke 命令；CLI 和 Backend 都必须在 Provider 调用前拒绝，Backend 还必须在 execution/event/quota/invocation 写入前拒绝。错误调用付费 capability 时返回 `checkout_required` 和可直接运行的 quote 命令；execution 状态、event、ProviderCalled 均保持不变。
+缺少 required input 时返回 `capability_input_invalid`，recovery 给出带占位符的同一 invoke 命令；CLI 和 Backend 都必须在 Provider 调用前拒绝，Backend 还必须在 execution/event/quota/invocation 写入前拒绝。错误调用付费 capability 时不得给出购买旁路，只能回到同一 Execution 的 `services next`；execution 状态、event、ProviderCalled 均保持不变。
 
 ## Agent Type / Host
 

package/docs/cli-reference/commands/services/next.md

@@ -37,7 +37,7 @@ itpay services next <service_execution_id> [--json]
       { "rank": 1, "title": "<title>", "safe_payload": { "<public_field>": "<value>" } }
     ]
   },
-  "instruction": "向用户展示编号和 safe_payload；用户选择后只在当前 Execution 提交对应 rank，不要新建 Execution。",
+  "instruction": "向用户展示编号和 safe_payload；若候选列表已满足用户目标，在此停止。仅在用户明确选择并希望继续时，才在当前 Execution 提交对应 rank。",
   "next": {
     "command": "itpay services action <id> --action select_candidate --actor-type human --status approved --candidate <rank> --json",
     "reason": "仅在用户明确选择后锁定来源候选"
@@ -65,10 +65,10 @@ itpay services next <service_execution_id> [--json]
       }
     ]
   },
-  "instruction": "这是当前 Graph 步骤对应的交付。向用户展示编号和 safe_payload；如用户选择，必须在当前 Execution 提交对应 rank。",
+  "instruction": "付费模糊搜索已完成。现在把 items 中的编号、title 和 safe_payload 展示给用户，然后停止。本结果是 agent-visible，不要调用 read-result。若用户的目标只是搜索候选企业，任务已经完成；只有用户之后明确选择某个候选并要求继续时，才执行 next.command。不要自动购买后续报告。",
   "next": {
     "command": "itpay services action <id> --action select_candidate --actor-type human --status approved --candidate <rank> --json",
-    "reason": "仅在用户明确选择后锁定来源候选"
+    "reason": "仅在用户明确选择候选并要求继续时执行"
   },
   "recovery": []
 }
@@ -119,7 +119,26 @@ itpay services next <service_execution_id> [--json]
 }
 ```
 
-其他执行阶段只返回 Execution、service、phase、类型化 `allowed_actions` 和一个服务端状态导出的命令。CLI 只把 Backend 的动作类型渲染成命令，不执行 Publication 中的任意 shell 文本。完成或空结果后不得建议重放已失效的 invoke。
+额度耗尽或候选已确认并进入付费 continuation 时，`services next` 必须重复价格、用户确认原话、停止条件和禁止动作；普通单 Execution 的 next 使用 `services checkout`，不暴露 Quote/Cart/Buy 编排。
+
+已有 Checkout 时，Backend 返回 `resume_checkout`，CLI 只能恢复同一 Checkout：
+
+```json
+{
+  "status": "checkout_pending",
+  "result": {
+    "service_execution_id": "<id>",
+    "service_id": "<service_id>",
+    "phase": "checkout",
+    "allowed_actions": [{ "type": "resume_checkout", "requires_human": true }]
+  },
+  "instruction": "当前 Execution 已经有一笔 Checkout。不要创建新的 Quote、Cart、Checkout 或 Execution。现在只执行 next.command，恢复并展示同一 Checkout 的付款入口。",
+  "next": { "command": "itpay services checkout <id> --resume --json", "reason": "恢复同一 Checkout，不创建第二笔" },
+  "recovery": []
+}
+```
+
+付款已确认但 Provider 尚在履约时只能等待并再次读取同一 Execution；不得新建 Execution、Checkout 或再次付款。其他执行阶段只返回 Execution、service、phase、类型化 `allowed_actions` 和一个服务端状态导出的命令。CLI 只把 Backend 的动作类型渲染成命令，不执行 Publication 中的任意 shell 文本。完成或空结果后不得建议重放已失效的 invoke。
 
 ## 退款访问锁
 

package/docs/cli-reference/commands/services/quote.md

@@ -4,7 +4,9 @@
 
 为当前 Service Execution 的一个付费 Capability 准备 Quote Lock。它只锁定可信输入、候选来源、价格、币种和有效期，不创建 Cart、Checkout、订单或 Provider 调用。
 
-**上游：** `services next` 返回 `prepare_quote`，以及当前 Execution 内已批准的候选或完整 required input。
+本命令是多 Execution 合并付款的高级入口。普通单 Execution 流程应使用 `services checkout`，不要把 `services quote` 当作 Checkout 失败后的替代路径。
+
+**上游：** 用户明确要求合并多个独立 Execution，且每个 Execution 的 Graph 当前都允许 `prepare_quote`。
 
 **下游：** `cart add --quote`。多个独立 Execution 的 Quote 可以加入同一 Cart。
 
@@ -53,6 +55,8 @@ itpay services quote <service_execution_id> --capability <capability_id>
 - `capability_input_invalid`：缺少 required input；不创建 Quote、Cart 或 Checkout。
 - `delivery_email_required`：先说明邮箱用于交付 claim link，再询问用户；禁止代填。
 - 候选未确认、来自其他 Execution、Quote 已存在冲突：Backend 拒绝且不改变 Execution。
+- `service_quote_not_allowed`：当前 Graph 不允许从当前 Execution 状态购买该 capability；不得换 capability、新建 Execution 或尝试其他购买命令，只回到同一 Execution 的 `services next`。
+- Backend 不支持当前交易合同时返回 `backend_contract_incompatible`，必须停止，不能改用 `services checkout`、`cart`、`buy` 或 `pay` 绕过。
 
 ## Agent Type / Host
 

package/docs/cli-reference/commands/services/start.md

@@ -14,7 +14,9 @@ itpay --agent-type <agent_type> services start <service_id>
   [--host <host>] [--target <target>] [--json]
 ```
 
-`service_id` 必须来自 Catalog。`--target` 只用于需要稳定消息目标的 Host。Buyer、Device 和 Agent instance 均来自签名 Agent session，不接受请求参数覆盖。
+`service_id` 必须来自 Catalog。`--target` 只用于需要稳定消息目标的 Host，例如 chat/channel/open ID；它不是搜索词或其他业务输入。Buyer、Device 和 Agent instance 均来自签名 Agent session，不接受请求参数覆盖。
+
+本命令不接收 capability 业务输入。它返回 `required_input` 和一条 `services invoke`（或其他当前合法动作）命令；把真实值填入那条命令的重复 `--input key=value`。例如企业关键词是 `--input keyword=美团`，不是 `--target 美团`。
 
 ## 标准输出
 
@@ -33,14 +35,14 @@ itpay --agent-type <agent_type> services start <service_id>
   },
   "instruction": "填写首选 capability 的 required_input；一次只提交当前 execution 所代表的服务意图。",
   "next": {
-    "command": "itpay services invoke <execution_id> --capability <capability_id> --input <key=value> --json",
+    "command": "itpay --agent-type <agent_type> services invoke <execution_id> --capability <capability_id> --input <key=value> --json",
     "reason": "执行当前允许的能力"
   },
   "recovery": []
 }
 ```
 
-Start API 只提供免费额度上限，不提供当前剩余额度，因此本命令不得虚构 `remaining`。不得输出全部 capability DTO、contract version、graph ID、buyer/device ID 或重复 guidance。若服务不存在，recovery 为 `catalog list`。设备 session 应由 CLI 自动登记或刷新；仅无法恢复时返回明确 enrollment 错误。
+Start API 只提供免费额度上限，不提供当前剩余额度，因此本命令不得虚构 `remaining`。不得输出全部 capability DTO、contract version、graph ID、buyer/device ID 或重复 guidance。若服务不存在，recovery 为 `catalog list`。设备 session 由 CLI 自动登记或刷新；401 `agent_device_session_required` 仅续期并重试一次，仍失败时返回错误，不循环。
 
 ## Agent Type / Host
 

package/docs/cli-reference/commands/skill.md

@@ -0,0 +1,17 @@
+# `itpay skill show`
+
+## 范围与意义
+
+读取 npm 包内置的完整 Agent Skill。与按 topic 渐进读取的 `docs` 不同，本命令故意一次返回完整 `SKILL.md`，用于首次 onboarding 和身份/session 规则恢复；不访问 Backend，不修改宿主配置或本地身份。
+
+```bash
+itpay [--agent-type <agent_type>] skill show itpay-buyer [--json]
+```
+
+当前只内置 `itpay-buyer`。`--json` 时完整 Markdown 位于 `result.content`；文本模式直接输出完整内容。
+
+未声明 Agent Type 时，`next` 是 `itpay install --json`。已声明时，`next` 是保留同一类型的 `catalog list --json`。未知名称返回 `skill_not_found`；包内文件缺失或损坏返回 `skill_unavailable` 并要求重装同版本 CLI。
+
+Skill 是操作和安全合同，不是服务端业务状态。执行时仍以每个命令当前 envelope 的 `result`、`instruction` 和 `next` 为准。
+
+所有 Agent Type 使用相同的 JSON 外壳、字段和命令参数。`workbuddy` 只在 `instruction` 中额外强调保持同一 Node/CLI launcher、持久写权限和减少内部诊断转述；它不改变输入或输出 schema。

package/docs/cli-reference/conventions.md

@@ -25,7 +25,9 @@ CLI 输出是给 Agent 执行的协议，不是后端 DTO 的调试转储。默
 - `result`：仅包含当前步骤必须使用或向用户说明的事实。
 - `instruction`：一条可直接当作 Agent prompt 使用的自然语言指令，不复述 `result`。
 - `next`：最多一个首选动作；流程结束时为 `null`。
+- `next.command` 是状态机允许的首选延续，不是无条件执行指令；当前结果已满足用户目标时，Agent 应展示结果并停止。
 - `recovery`：成功时通常为空；失败或中断时最多两个动作。
+- 一旦命令声明 `--agent-type` 或 `ITPAY_AGENT_TYPE`，所有 ItPay `next.command` 和 `recovery.command` 都保留同一类型。
 - 相同事实不得同时出现在顶层、`agent_guidance`、`next_actions` 等多个位置。
 - 默认隐藏 buyer、device、contract version、compiled graph、quote lock、内部 event ID 等实现细节。
 - token、付款 URL 和本地二维码路径只在确实需要交给用户时返回，并不得写入日志型命令。
@@ -66,6 +68,8 @@ next: <one command>
 - 不得只返回 `invalid_state`；必须说明当前状态和合法恢复入口。
 - 重试应复用同一 cart、checkout、execution、order 或 refund ID，不得默认创建新资源。
 - 用户口头说“已付款”不是支付事实；仅服务端 `verified` 状态有效。
+- `agent_device_session_required` 只触发一次 session 续期和同请求重试；第二次失败必须返回，不得循环或换身份。
+- `device_state_unwritable` 表示当前运行环境不能可靠持久化 `~/.itpay-v3`；保持同一 Agent Type 与 CLI/Node launcher，恢复 Host 写权限后重试原命令，不得手工造 lock、删除身份或换运行时碰运气。
 
 ## Instruction 模板
 
@@ -91,4 +95,3 @@ Instruction 只回答当前最重要的一件事：
 - 是否需要邮箱来自 `delivery_email_required`。
 - 是否可直接给 Agent 来自 `agent_visible` / `delivery_mode`。
 - 下一步来自 Service Execution read model，不由 CLI 猜业务流程。
-

package/docs/cli-reference/index.md

@@ -21,6 +21,7 @@
 - [`itpay catalog`](commands/catalog/index.md)
   - [`itpay catalog list`](commands/catalog/list.md)
 - [`itpay install`](commands/install.md) - 查看指定 Agent 的安装说明
+- [`itpay skill show`](commands/skill.md) - 一次读取完整内置 Buyer Skill
 - [`itpay docs`](commands/docs/index.md)
   - [`itpay docs list`](commands/docs/list.md)
   - [`itpay docs show`](commands/docs/show.md)

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@itpay/cli",
-  "version": "2.0.5",
+  "version": "2.0.7",
   "description": "ItPay CLI for V3 checkout, payment, order, refund, and agent-facing render flows.",
   "type": "module",
   "bin": {

package/skills/itpay-buyer/SKILL.md

@@ -10,16 +10,38 @@ description: >
 
 Use the CLI as the only ItPay control surface. Do not recreate API calls or hardcode a service-specific sequence.
 
+## Critical Rules
+
+- Keep one honest Agent Type, one CLI/Node launcher, and one Host-approved permission context for the whole flow.
+- Treat `next.command` as the preferred continuation, not an unconditional command. If the current result already satisfies the user's stated goal, present it and stop.
+- Keep internal parsing, retries, sandbox diagnosis, and command translation out of the user response; report useful progress, results, and real human decisions only.
+- If Device state is not writable, stop. Do not switch Node, manually create lock files, delete identity, or rotate Agent Type.
+
 ## Bootstrap
 
 ```bash
 npm install -g @itpay/cli
+itpay readyz --json
+itpay skill show itpay-buyer --json
+itpay install --json
 itpay install <agent_type> --json
 itpay --agent-type <agent_type> readyz --json
-itpay --agent-type <agent_type> docs show quickstart --json
 ```
 
-Supported types are `codex-desktop`, `codex-cli`, `claude-code-desktop`, `claude-code-cli`, and `workbuddy`. Use the real stable runtime type; Host is presentation only.
+Follow each returned `next.command`. `readyz` deliberately points back to this complete Skill. If the Skill was read without an Agent Type, choose the real runtime with `install`; after typed `readyz`, read the Skill again and continue to Catalog.
+
+Supported types are `codex-desktop`, `codex-cli`, `claude-code-desktop`, `claude-code-cli`, and `workbuddy`. State the real stable runtime type honestly. Do not identify a window, chat, task, process, or model session as a new Agent.
+
+## Identity And Sessions
+
+- One local Ed25519 private key represents this ItPay installation. Never expose, copy, or rotate it to recover quota.
+- Device registrations are scoped by exact Backend API base URL. `dev`, `test`, and `app` therefore have separate server device IDs, quota lineage, Agent instances, and sessions while using the same local key.
+- Each Backend registration has one Agent Instance per `agent_type`. Different windows and chats of the same type reuse it; different types get separate instances under that registration.
+- Every commerce command must keep the explicit `--agent-type` returned in `next` and `recovery`, or use one stable `ITPAY_AGENT_TYPE`. Never fall back to another type previously used on the machine.
+- The CLI renews an expired or rejected device session and retries the same request exactly once. If that retry still fails, stop and report it; do not loop, create a new identity, or switch Agent Type.
+- A revoked v2 device is not replaced automatically. It requires an explicit operator recovery path.
+- If an operator confirms that one Backend registration database was reset, use `device recover --confirm-backend-reset` for that selected Backend only. This preserves the private key and every other Backend registration; never use it for ordinary session expiry or revocation.
+- `--host` selects presentation. `--target` is only the destination chat/channel/open ID required by some Hosts. Neither is business input or identity.
 
 ## Envelope Rule
 
@@ -41,17 +63,20 @@ itpay --agent-type <agent_type> services start <service_id> --json
 
 Then execute the exact `next.command` returned by each step. It may invoke a capability, ask for a selection, create a Checkout, wait for human action, return an Agent-visible result, or read a protected result after grant.
 
+`services start` creates the Execution and returns the preferred capability plus its `required_input`. Put business values only in repeated `--input key=value` options on the returned `services invoke`, `services quote`, or `services checkout` command. For example, a company keyword belongs in `--input keyword=美团`; it never belongs in `--target`.
+
 Rules:
 
 - One independent service intent uses one Service Execution.
 - Every candidate list belongs to its source Service Execution. After a human selects a rank, submit the selection on that same Execution; never copy it into a new Execution or construct a candidate.
-- A paid step is `services quote -> cart add --quote -> buy --cart`. Quote locks service input and price; Cart may combine Quotes from separate Executions without merging their delivery.
-- `services checkout` is the one-item shortcut for the same Quote, Cart and Checkout rules.
+- A normal single-Execution paid step uses the exact `services checkout` command returned by the CLI, but only after the instruction has made the price visible and the human explicitly agrees. The command internally uses the same Quote, Cart and Checkout rules.
+- `services quote -> cart add --quote -> buy --cart` is only for a human who explicitly asks to combine Quotes from multiple independent Executions. Never use it as a fallback when `services checkout` fails.
 - Ask for required email/contact fields; explain their delivery purpose and never invent them.
-- When Checkout is ready, make both the ItPay QR/image and URL visible on the current human surface.
+- When Checkout is ready, make the amount, ItPay QR/image and URL visible on the current human surface, then stop. Do not query until the human completes the action or asks for status.
 - Normal payment happens on the ItPay Checkout page. `itpay pay` and `buy --pay` are operator escape hatches.
 - Payment is confirmed only by Backend Checkout or Order state.
 - Agent-visible results come from `services next`; do not call `read-result` for them.
+- Quota exhaustion, candidate selection, Checkout pending, payment verified and delivery each remain on the same Execution. Never create a replacement Execution to escape one of those states.
 - An Execution may have delivery history; always follow `services next` for the backend-selected current delivery instead of reusing an older result.
 - Protected results require a current human grant. The grant is scoped to one delivery, approved fields and frozen Agent audience, and expires after 15 minutes.
 - A pending refund locks every delivery path and revokes existing grants.
@@ -65,8 +90,9 @@ itpay --agent-type <agent_type> next --json
 itpay --agent-type <agent_type> services list --json
 itpay --agent-type <agent_type> services next <service_execution_id> --json
 itpay --agent-type <agent_type> services checkout <service_execution_id> --resume --json
-itpay checkout --id <checkout_id> --token <display_token> --json
+itpay --agent-type <agent_type> checkout --id <checkout_id> --token <display_token> --json
 itpay --agent-type <agent_type> refund get <refund_request_id> --json
+itpay --agent-type <agent_type> device recover --confirm-backend-reset --json
 ```
 
 ## Safety
@@ -83,6 +109,7 @@ itpay --agent-type <agent_type> refund get <refund_request_id> --json
 itpay docs list --json
 itpay docs search <term> --json
 itpay docs show <topic> --json
+itpay skill show itpay-buyer --json
 ```
 
 The normative command contracts are packaged under `docs/cli-reference`.