@itpay/cli 2.0.14 → 2.0.16

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (56) hide show
  1. package/README.md +5 -4
  2. package/dist/src/commands/buy.js +3 -0
  3. package/dist/src/commands/checkout.js +4 -2
  4. package/dist/src/commands/checkout_handoff.js +7 -0
  5. package/dist/src/commands/compatibility.js +0 -1
  6. package/dist/src/commands/guidance.js +6 -5
  7. package/dist/src/commands/install.js +15 -10
  8. package/dist/src/commands/readyz.js +6 -2
  9. package/dist/src/commands/services.js +14 -6
  10. package/dist/src/main.js +60 -27
  11. package/dist/src/render/telegram.js +51 -25
  12. package/dist/src/state/client_context.js +2 -0
  13. package/dist/src/state/config.js +48 -7
  14. package/docs/agent/buyer/identity-and-sessions.json +10 -10
  15. package/docs/agent/buyer/install-and-setup.json +13 -12
  16. package/docs/agent/buyer/payment-flow.json +1 -0
  17. package/docs/agent/buyer/quickstart.json +4 -2
  18. package/docs/agent/buyer/render-hosts.json +18 -2
  19. package/docs/cli-reference/agent-types.md +12 -2
  20. package/docs/cli-reference/commands/buy.md +9 -4
  21. package/docs/cli-reference/commands/cart/add.md +1 -1
  22. package/docs/cli-reference/commands/cart/clear.md +1 -1
  23. package/docs/cli-reference/commands/cart/index.md +1 -1
  24. package/docs/cli-reference/commands/cart/next.md +1 -1
  25. package/docs/cli-reference/commands/cart/remove.md +2 -2
  26. package/docs/cli-reference/commands/cart/show.md +1 -1
  27. package/docs/cli-reference/commands/catalog/index.md +1 -1
  28. package/docs/cli-reference/commands/checkout.md +5 -3
  29. package/docs/cli-reference/commands/device.md +1 -1
  30. package/docs/cli-reference/commands/docs/index.md +1 -1
  31. package/docs/cli-reference/commands/docs/list.md +1 -1
  32. package/docs/cli-reference/commands/docs/search.md +1 -1
  33. package/docs/cli-reference/commands/docs/show.md +1 -1
  34. package/docs/cli-reference/commands/install.md +46 -12
  35. package/docs/cli-reference/commands/next.md +1 -1
  36. package/docs/cli-reference/commands/readyz.md +61 -10
  37. package/docs/cli-reference/commands/refund/cancel.md +1 -1
  38. package/docs/cli-reference/commands/refund/create.md +1 -1
  39. package/docs/cli-reference/commands/refund/index.md +1 -1
  40. package/docs/cli-reference/commands/refund/list.md +1 -1
  41. package/docs/cli-reference/commands/services/action.md +1 -1
  42. package/docs/cli-reference/commands/services/checkout.md +5 -1
  43. package/docs/cli-reference/commands/services/events.md +1 -1
  44. package/docs/cli-reference/commands/services/get.md +1 -1
  45. package/docs/cli-reference/commands/services/index.md +1 -1
  46. package/docs/cli-reference/commands/services/invoke.md +1 -1
  47. package/docs/cli-reference/commands/services/list.md +1 -1
  48. package/docs/cli-reference/commands/services/read-result.md +1 -1
  49. package/docs/cli-reference/conventions.md +7 -1
  50. package/docs/skill-bundle-rollout/01-mcp-authentication.md +256 -0
  51. package/docs/skill-bundle-rollout/02-platform-bundle-repositories.md +279 -0
  52. package/docs/skill-bundle-rollout/03-platform-publishing.md +271 -0
  53. package/docs/skill-bundle-rollout/04-first-wave-platforms.md +32 -0
  54. package/docs/skill-bundle-rollout/README.md +99 -0
  55. package/package.json +1 -1
  56. package/skills/itpay/SKILL.md +4 -4
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@itpay/cli",
3
- "version": "2.0.14",
3
+ "version": "2.0.16",
4
4
  "description": "The single ItPay CLI entry point for buy workflows and future sell workflows.",
5
5
  "type": "module",
6
6
  "bin": {
@@ -19,8 +19,8 @@ Use the CLI as the only ItPay control surface. Never recreate API calls or hardc
19
19
 
20
20
  ## Critical Rules
21
21
 
22
- - The production CLI Backend is fixed to `https://app.itpay.ai`. Never use an environment variable, alternate launcher, or recovery path to redirect it.
23
- - Keep one honest Agent Type, one CLI/Node launcher, and one Host-approved permission context for the whole flow. Supported types: `codex-desktop`, `codex-cli`, `claude-code-desktop`, `claude-code-cli`, `workbuddy`.
22
+ - The CLI defaults to production `https://app.itpay.ai`. Only an explicit test may use the exact prefix `ITPAY_BACKEND_URL=https://dev.itpay.ai`; never use another Backend. While testing dev, execute every returned command unchanged so that prefix is preserved.
23
+ - Keep one honest Agent Type, one CLI/Node launcher, and one Host-approved permission context for the whole flow. Supported types: `codex-desktop`, `codex-cli`, `claude-code-desktop`, `claude-code-cli`, `workbuddy`, `kimi-code`, `openclaw`.
24
24
  - WorkBuddy: before any ItPay Bash command that persists `~/.itpay-v3`, set the Shell tool parameter `dangerouslyDisableSandbox` to `true`. If the human denies that permission, the command did not run: stop and report it.
25
25
  - Windows, tasks, chats, processes, and model sessions are not new Agents. Never rotate Agent Type or identity to reset quota.
26
26
  - 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.
@@ -45,11 +45,11 @@ If `backend_contract_incompatible` returns `result.required_cli_version`, stop e
45
45
  ## Identity And Sessions
46
46
 
47
47
  - One local Ed25519 private key represents this ItPay installation. Never expose, copy, or rotate it to recover quota.
48
- - The CLI uses one production Device registration at `https://app.itpay.ai` with one Agent Instance per `agent_type`. Different windows and chats of the same type reuse it; different types get separate instances under that registration.
48
+ - The CLI uses one local signing key with separate official Backend registrations. Each registration has one Agent Instance per `agent_type`; different windows and chats of the same type reuse it.
49
49
  - 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.
50
50
  - 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.
51
51
  - A revoked v2 device is not replaced automatically. It requires an explicit operator recovery path.
52
- - If an operator confirms that the `https://app.itpay.ai` Device registration database was reset, use `device recover --confirm-backend-reset`. This preserves the private key; never use it for ordinary session expiry or revocation.
52
+ - If an operator confirms that the current official Backend registration database was reset, use the complete returned `device recover --confirm-backend-reset` command. This preserves the private key and other Backend registration; never use it for ordinary session expiry or revocation.
53
53
  - `--host` selects presentation. `--target` is only the destination chat/channel/open ID required by some Hosts. Neither is business input or identity.
54
54
 
55
55
  ## Envelope Rule