monacloud-mcp 0.2.1 → 0.3.1

package/README.md

@@ -1,8 +1,8 @@
 # monacloud-mcp
 
-`monacloud-mcp` là MCP hợp nhất của MONA Cloud: cài một lần, đăng nhập một MONA Pass và dùng chung ví VND để quản lý tài khoản, chạy app/VPS, tích hợp MONA Pay và đọc catalog MONA Agent ngay trong Claude Code, Codex hoặc Cursor.
+`monacloud-mcp` là MCP hợp nhất của MONA Cloud: cài một lần, đăng nhập một MONA Pass và dùng chung ví VND để quản lý tài khoản, chạy app/VPS, tích hợp MONA Pay, gửi email giao dịch bằng MONA Mail và đọc catalog MONA Agent ngay trong Claude Code, Codex hoặc Cursor.
 
-Human chỉ cần đăng ký, nạp tiền và cung cấp OTP/KYC khi bắt buộc. Các bước tạo tài nguyên, đọc trạng thái, cấu hình webhook, test và deploy được thiết kế để AI agent làm qua MCP.
+Human đăng ký, duyệt chi phí, thêm DNS khi cần, nạp tiền và cung cấp OTP/KYC khi bắt buộc. Các bước tạo tài nguyên, đọc trạng thái, cấu hình webhook, test và deploy được thiết kế để AI agent làm qua MCP.
 
 ## Yêu cầu
 
@@ -76,7 +76,7 @@ Tên tool dùng `snake_case` để giữ tương thích với prompt MONA Pay c
 
 ### MONA Pay
 
-`monacloud-mcp` import `monapay-mcp` và re-export toàn bộ tool của package, không copy implementation. Dependency range là `^0.3.0`; bộ dependency offline tại lần verify này là 0.5.5 với 47 tool MONA Pay, gồm các nhóm:
+`monacloud-mcp` import `monapay-mcp` và re-export toàn bộ tool của package, không copy implementation. Dependency range là `^0.5.5`; bộ dependency offline tại lần verify này là 0.5.5 với 47 tool MONA Pay, gồm các nhóm:
 
 - hồ sơ và nối ACB/VA bằng hai lần OTP;
 - payment profile, checkout, VietQR, sandbox transaction và đối soát;
@@ -91,7 +91,7 @@ Các tên cũ như `monapay_create_qr`, `monapay_link_bank_start`, `monapay_crea
 | Tool | Công dụng |
 |---|---|
 | `cloud_link` | Xác nhận direct MONA Pass; chỉ đổi sang `vc_live_*` nếu upstream còn ở chế độ cũ |
-| `cloud_vps_create` | Tạo LXC theo `package_slug` hoặc CPU/RAM/đĩa |
+| `cloud_vps_create` | Hourly theo cấu hình; monthly theo `plan_code`, `period: month/year`, kiểm ví đủ giá kỳ |
 | `cloud_db_create` | Tạo MongoDB, PostgreSQL hoặc MySQL |
 | `cloud_job_status` | Poll job tới trạng thái cuối, có timeout |
 | `cloud_services_list` | Liệt kê VPS/database |
@@ -101,6 +101,41 @@ Các tên cũ như `monapay_create_qr`, `monapay_link_bank_start`, `monapay_crea
 
 `cloud_service_stop` không bị chặn bởi số dư để người dùng luôn có thể hạn chế chi phí. Những lệnh tạo/start/rebuild thật đọc `GET /v1/balance` trước khi gọi compute MONA Cloud.
 
+### MONA Mail
+
+MONA Mail là dịch vụ gửi email giao dịch cho phần mềm và AI agent của người Việt: một API, trả VND, không cần thẻ, thuộc nhóm MONA Cloud của The MONA Group.
+
+20 tool `mail_*` dùng MONA Pass sẵn có; tài khoản Mail được tạo tự động ở request đầu. Site: https://monamail.vn, API: https://api.monamail.vn.
+
+| Tên | Việc |
+|---|---|
+| `mail_account` | Đọc tài khoản, email chủ, quota và bước kế tiếp |
+| `mail_plans` | Đọc giá và quota hiện hành của các gói |
+| `mail_plan_set` | Đổi gói, trừ ví VND khi chọn gói trả phí |
+| `mail_send` | Gửi OTP/thông báo hoặc thử bằng `sandbox: true` |
+| `mail_status` | Đọc trạng thái, events và nội dung sandbox |
+| `mail_list` | Lọc lịch sử theo trạng thái, người nhận và thời gian |
+| `mail_domain_add` | Thêm domain, trả records DNS và hướng dẫn |
+| `mail_domain_verify` | Kiểm DKIM và xác minh domain |
+| `mail_domain_cloudflare` | Thêm DNS bằng token Cloudflare của người dùng, dùng một lần, không lưu/log |
+| `mail_domains_list` | Liệt kê domain cùng trạng thái |
+| `mail_api_key_create` | Tạo key live/test, secret chỉ trả một lần |
+| `mail_api_keys_list` | Xem prefix và trạng thái key |
+| `mail_api_key_revoke` | Thu hồi key của app |
+| `mail_webhook_create` | Đăng ký HTTPS endpoint và các sự kiện email |
+| `mail_webhooks_list` | Liệt kê webhook |
+| `mail_webhook_test` | Gửi payload `email.delivered` mẫu |
+| `mail_suppressions_list` | Xem địa chỉ ngừng gửi và lý do |
+| `mail_suppression_remove` | Gỡ suppression của tài khoản; không gỡ lớp toàn hệ |
+| `mail_template_create` | Tạo mẫu với biến `{{ten_bien}}` |
+| `mail_stats` | Đọc thống kê giao thư và bounce theo thời gian |
+
+`mail_send` nhận 1 đến 50 người nhận, tối đa 10 tags, `subject` tối đa 998 ký tự và ít nhất một trong `html`/`text`. Khi dùng `template_id`, template thay cho `subject`/`html`/`text`. Sender `onboarding@monamail.vn` chỉ gửi tới email chủ từ `mail_account`; domain riêng cần verified trước khi gửi.
+
+Key chỉ trả một lần; ghi vào `.env` của app dưới tên `MONAMAIL_API_KEY`, không cần in ra chat. MCP tiếp tục dùng MONA Pass; app dùng SDK `monamail` với key `mm_live_` hoặc `mm_test_`. Sandbox bằng `mail_send({ ..., sandbox: true })` gửi header `X-Mona-Sandbox: 1` và trả `sandbox: true`; sandbox không gửi ra Internet, không tính quota hoặc trừ ví. Dùng `mail_status` để xem `sandbox_preview`.
+
+Mọi POST gửi `Idempotency-Key` từ `idempotency_key` hoặc tự tạo `mcp-mail-<uuid>`. Truyền key ổn định khi cần retry: trong 24 giờ, cùng key và body trả response cũ; khác body trả `idempotency_conflict`. MCP đưa key vào header, không đưa `sandbox` vào body API. Giá gói lấy bằng `mail_plans`; lỗi thiếu ví từ `mail_plan_set` hướng dẫn gọi `cloud_topup`.
+
 ## Thử 0đ bằng sandbox
 
 Truyền `sandbox: true` cho `cloud_vps_create`, `cloud_db_create`, `cloud_service_start`, `cloud_service_rebuild` hoặc `cloud_agent_deploy` để thử luồng mà không cần số dư ví. Có thể bật mặc định cho cả MCP process bằng `MONACLOUD_SANDBOX=1`; các alias `vibecloud_*` có cùng hành vi.
@@ -124,8 +159,9 @@ cloud_services_list({ sandbox: true })
 ## Resource và prompt
 
 - `monacloud://llms`: mô tả máy đọc của toàn stack MONA Cloud.
-- `monacloud://status`: health tổng hợp MONA Pass, Billing, compute MONA Cloud và MONA Pay.
-- Prompt `dung-app-ban-hang-monacloud`: chuỗi VPS → database → VA/QR → webhook → deploy, chỉ dừng để hỏi nạp tiền hoặc OTP bắt buộc.
+- `monacloud://status`: health tổng hợp MONA Pass, Billing, compute MONA Cloud, MONA Pay và MONA Mail (`/v1/healthz`).
+- Prompt `dung-app-ban-hang-monacloud`: chuỗi VPS → database → VA/QR → webhook → deploy, đọc giá, duyệt chi phí rồi tạo; repo git dùng `cloud_app_create` (đang mở).
+- Prompt `gui-mail-otp-monamail(app_name?, framework?, domain?)`: account → thử onboarding → domain/DNS → verify → API key → `.env` → SDK OTP → webhook bounced; chỉ dừng ở bước thêm DNS hoặc nạp tiền.
 
 ## Spend guard và lỗi cho AI
 
@@ -160,6 +196,17 @@ Agent thực hiện:
 
 Chi tiết dành riêng cho agent: [`docs/ai-agent.md`](docs/ai-agent.md).
 
+## Ví dụ một lượt: gửi mail OTP
+
+Người dùng nói: “Tích hợp gửi mail OTP cho app shop bằng MONA Mail, domain shop.vn.”
+
+1. `mail_account`: lấy email chủ, quota và domain đã xác minh.
+2. Nếu chưa có domain, `mail_send` từ `onboarding@monamail.vn` tới email chủ, dùng idempotency key riêng; `mail_status` kiểm kết quả.
+3. `mail_domain_add({ domain: "shop.vn" })`: đưa records để user thêm DNS, hoặc gọi `mail_domain_cloudflare` bằng token của họ; sau đó `mail_domain_verify`.
+4. `mail_api_key_create({ name: "shop-otp", mode: "live" })`: ghi key trực tiếp vào `.env` dưới tên `MONAMAIL_API_KEY`.
+5. Viết server dùng `new MonaMail(process.env.MONAMAIL_API_KEY)` và `monamail.emails.send(...)` với `tags: ["otp"]`; kiểm thư bằng `mail_status`.
+6. Viết endpoint HMAC, `mail_webhook_create` với `events: ["email.bounced"]`, lưu secret rồi `mail_webhook_test`; khi thiếu ví gọi `cloud_topup` và chờ user nạp.
+
 ## Biến môi trường
 
 | Biến | Mặc định | Ý nghĩa |
@@ -167,6 +214,7 @@ Chi tiết dành riêng cho agent: [`docs/ai-agent.md`](docs/ai-agent.md).
 | `MONACLOUD_ISSUER` | `https://pass.monacloud.vn/realms/mona` | OIDC issuer |
 | `MONACLOUD_BILLING_URL` | `https://billing.monacloud.vn` | Billing/ví API |
 | `MONAPAY_API` | `https://api.monapay.vn` | MONA Pay API |
+| `MONAMAIL_API` | `https://api.monamail.vn` | MONA Mail API, dùng Bearer MONA Pass của MCP |
 | `MONACLOUD_API` | `https://api.monacloud.vn` | Compute API của MONA Cloud |
 | `MONACLOUD_CONSOLE_URL` | `https://monacloud.vn/console` | URL trả cho bước human |
 | `MONACLOUD_TOKEN` | — | PAT/access token ưu tiên token store |
@@ -189,3 +237,33 @@ node --test
 ```
 
 Test dùng Node built-in, MCP transport thật qua stdio, process con và mock HTTP local. Trong sandbox cấm bind socket, test tự dùng fetch fixture tương đương. Bộ test không gọi Internet.
+
+## Mới ở 0.3.0: gói tháng, hoá đơn và app từ git
+
+| Tool mới | Công dụng |
+|---|---|
+| `cloud_plan_list` | Bảng gói và giá tháng/năm, gợi ý theo CPU/RAM/đĩa |
+| `cloud_subscription_list` / `cloud_subscription_update` | Đọc gói, đổi chu kỳ, auto-renew; huỷ với `cancel_action: hourly/stop` |
+| `cloud_invoice_list` / `cloud_invoice_pdf` | Xem hoá đơn và tải PDF về file tạm riêng tư |
+| `cloud_credit_redeem` | Dùng mã credit được người dùng cung cấp |
+| `cloud_app_create` / `cloud_app_list` / `cloud_app_get` | Deploy public repo HTTPS, poll job và đọc URL; **đang mở** |
+| `cloud_app_deploy` / `cloud_app_env_set` | Deploy lại, thay env; **đang mở** |
+| `cloud_app_domain_add` / `cloud_app_logs` / `cloud_app_delete` | CNAME domain, log build, xoá app; **đang mở** |
+| `cloud_app_host_list` | Xem host và tài nguyên/chi phí; **đang mở** |
+
+15 tool mới có 15 alias `vibecloud_` tương ứng. Tổng với MONA Pay 0.5.5 đang có: **133 tool**, gồm 20 Mail và 26 alias compute. Package/MCP binary version: **0.3.0**.
+
+```text
+cloud_plan_list({ ram_gb: 4 })
+# Đọc ví, báo giá, chờ duyệt rồi tạo:
+cloud_vps_create({ app_name: "shop", billing_mode: "monthly", plan_code: "kinh-doanh", period: "month" })
+cloud_invoice_pdf({ invoice_id: "<id>" })
+cloud_app_host_list()
+cloud_app_create({ repo_url: "https://github.com/example/shop.git", branch: "main", build_type: "nixpacks", sandbox: true })
+```
+
+Monthly bỏ qua CPU/RAM/đĩa và package_slug, đọc cấu hình/giá từ plan và guard toàn bộ giá tháng/năm. Backend chưa nhận monthly sandbox: MCP thử cấu hình plan qua hourly sandbox 0đ, trả giá thật trong `estimate`, không tạo subscription. Khi tạo thật phải tắt `MONACLOUD_SANDBOX` nếu đã bật env.
+
+Khi user nói “deploy repo”, đọc host; chưa có host thì sandbox `cloud_app_create` để ước tính, hỏi duyệt rồi tạo thật và kiểm URL. Tool chờ job tối đa 600 giây; dùng `wait:false` và `cloud_job_status` nếu host MCP có timeout ngắn. Endpoint Wave B đang mở, lỗi API được báo thật.
+
+Hợp đồng HTTP, đầy đủ tham số, ví dụ billing/deploy, PDF và giới hạn rollout: [docs/wave-ab.md](docs/wave-ab.md).

package/STATUS.md

@@ -1,8 +1,76 @@
-# STATUS — monacloud-mcp 0.2.1
+# STATUS — monacloud-mcp 0.3.0
 
-Updated: 2026-09-04 (Asia/Ho_Chi_Minh)
+Updated: 2026-09-05 (Asia/Ho_Chi_Minh)
 
-## Hoàn thành
+## 0.3.0 — Wave A/B hoàn tất (05/09/2026)
+
+- [x] 6 tool billing: `cloud_plan_list`, `cloud_subscription_list`, `cloud_subscription_update`, `cloud_invoice_list`, `cloud_invoice_pdf`, `cloud_credit_redeem`.
+- [x] `cloud_vps_create`/`vibecloud_create_vps` nhận hourly/monthly, plan_code, month/year. Monthly bỏ sizing hourly; estimate và spend guard dùng đúng toàn bộ giá kỳ từ API, gồm gói 0đ.
+- [x] 9 tool app từ git: `cloud_app_create`, `cloud_app_list`, `cloud_app_get`, `cloud_app_deploy`, `cloud_app_env_set`, `cloud_app_domain_add`, `cloud_app_logs`, `cloud_app_delete`, `cloud_app_host_list`. Mô tả VI/EN ghi **đang mở**, gọi endpoint thật qua client; test HTTP mock.
+- [x] 15 alias `vibecloud_` mới, dùng chung schema/handler. Tổng stdio **133 tool = 83 cũ + 20 Mail + 30 Wave A/B**, 2 resource, 2 prompt. Giữ nguyên tích hợp Mail/MONA Pay đang có.
+- [x] App create/deploy poll tối đa 600 giây; trả URL/app_id/application_id, chuẩn hoá `result.estimated_app_host` thành `estimate`. Job error/failed/cancelled trả `app_deploy_failed`; timeout giữ job_id, không POST lại.
+- [x] Sandbox header `X-Vibecloud-Sandbox: 1`, env `MONACLOUD_SANDBOX=1`, bỏ Billing; job poll theo ID. Monthly sandbox thử cấu hình plan qua **hourly sandbox**, báo rõ chưa tạo subscription vì Wave A từ chối monthly sandbox.
+- [x] PDF giữ nguyên binary, file 0600/thư mục tạm 0700, không dùng remote filename hay follow redirect. Lỗi HTTP không tạo file giả.
+- [x] Instructions/resource, prompt dựng app, agent_* và catalog hướng “deploy repo” sang cloud_app_create; đọc → ước tính → duyệt nếu cần → làm, sandbox trước khi chưa có host.
+- [x] MCP và CLI cùng version **0.3.0**. README, [docs/wave-ab.md](docs/wave-ab.md), agent guide và CLI docs có bảng tool/lệnh, ví dụ, giới hạn rollout.
+
+Ví dụ gọi:
+
+```text
+cloud_plan_list({ ram_gb: 4 })
+cloud_vps_create({ app_name: "shop", billing_mode: "monthly", plan_code: "kinh-doanh", period: "month" })
+cloud_subscription_update({ service_id: "<id>", auto_renew: false, cancel_action: "stop" })
+cloud_invoice_pdf({ invoice_id: "<id>" })
+cloud_credit_redeem({ code: "<mã đã duyệt>" })
+cloud_app_create({ repo_url: "https://github.com/example/shop.git", build_type: "nixpacks", sandbox: true })
+```
+
+Gate cuối:
+
+```text
+mcp: npm test → 35 tests, 35 pass, 0 fail, 0 skip (bao gồm tsc)
+cli: npm test → 31 tests, 31 pass, 0 fail, 0 skip
+```
+
+CLI có test executable → MCP thật → HTTP mock cho plans, VPS monthly, PDF, sandbox, duyệt chi phí và deploy/build lỗi. Stdio xác nhận version 0.3.0, 133 tool và không có stderr chứa secret.
+
+Nguồn hợp đồng: snapshot `ctx/openapi.json` vẫn là **0.2.0**, thiếu Wave A/B. Đối chiếu offline schema/router Wave A và Wave B tại repo `vibecloud` trên cùng máy; giữ snapshot gốc và ghi provenance trong docs. Wave B public HTTPS repo, PUT env, query `deployment`, estimate `result.estimated_app_host`. CLI chuyển SSH remote phổ biến sang public HTTPS tương đương, không cấp quyền private repo.
+
+Không chạy npm install, không gọi Internet/production, không publish. Toàn bộ phát triển/test trong hai workspace và thư mục tạm. Wave B live chưa kiểm vì brief yêu cầu offline.
+
+Kiểm tra đóng gói offline: `npm pack --dry-run --json --offline --ignore-scripts` PASS (MCP 30 file), đủ source build/template/docs mới. Dùng npm CLI trực tiếp với config rỗng và `NODE_USE_SYSTEM_CA=0` để tránh lỗi Keychain/SecItemCopyMatching của Node trên runner. Không tạo tarball và không publish.
+
+CODEX DONE
+
+## 0.3.0 — MONA Mail
+
+- [x] Thêm đủ 20 tool `mail_*` theo CONTRACT-MONA-MAIL-API §5 trong `src/mail.ts`, đăng ký sau nhóm compute `cloud_*`.
+- [x] `MONAMAIL_API` mặc định `https://api.monamail.vn`; `CloudClients.mail()` dùng `requestJson` và `auth.accessToken()` MONA Pass, không có token cache Mail riêng.
+- [x] Mọi POST có `Idempotency-Key` từ `idempotency_key` hoặc `mcp-mail-<uuid>`; `mail_send` chuyển `sandbox: true` thành `X-Mona-Sandbox: 1` và đánh dấu response.
+- [x] Schema chặn email sai, trên 50 người nhận, trên 10 tags, subject trên 998 ký tự, gói/mode/event ngoài enum, webhook không dùng HTTPS và tham số lạ. Domain chuyển lowercase/IDN sang punycode.
+- [x] Tool mô tả VI/EN có tình huống sử dụng; domain trả records và hướng dẫn DNS/Cloudflare. API key chỉ trả một lần để app lưu `.env` với tên `MONAMAIL_API_KEY`; không thêm log token/key, không lưu token Cloudflare.
+- [x] Lỗi Mail qua `CloudError`: giữ thông tin API, gồm `403 domain_not_verified`; `402 mail_plan_set` trả `insufficient_funds` và bước tiếp theo nhắc `cloud_topup`. `src/http.ts`, `src/errors.ts` và hành vi lỗi tool cũ giữ nguyên.
+- [x] Instructions/entity, `monacloud://llms` và health MONA Mail `/v1/healthz` đã cập nhật. Có prompt `gui-mail-otp-monamail` với account → onboarding → DNS → verify → key → `.env` → SDK OTP → webhook bounced.
+- [x] README có bảng 20 tool, ví dụ OTP 6 bước và env Mail; `docs/ai-agent.md` có ranh giới human DNS/nạp tiền, sandbox, webhook HMAC và idempotency 24 giờ.
+- [x] Version package, MCP server và CLI đồng bộ `0.3.0`. `src/index.ts` chỉ đổi version; không sửa `src/monapay.ts`.
+
+Gate ngày 05/09/2026:
+
+```text
+$ node_modules/.bin/tsc -p tsconfig.json
+exit 0, không có diagnostic
+
+$ node --test test/*.test.mjs
+tests 23, pass 23, fail 0
+```
+
+Stdio process thật xác nhận **103 tool = 83 cũ + 20 Mail**, 2 resource, 2 prompt, server version `0.3.0`. Test bao phủ auth/header/body, sandbox, records DNS, key một lần, HTTP 402/403/409/429, GET/query/DELETE 204, schema và prompt. Test cũ về compute, MONA Pay, alias và catalog đều xanh.
+
+Lựa chọn theo contract: `subject` được bỏ khi có `template_id` vì §3 cho phép template thay nội dung; gửi trực tiếp bắt buộc subject và ít nhất html/text. Các POST ngoài `mail_send` cũng nhận `idempotency_key` tuỳ chọn để retry an toàn. Giá/quota và quyền domain vẫn do API quyết định, không hard-code giá gói.
+
+Toàn bộ thay đổi và thư mục tạm của gate nằm trong workspace MCP; thư mục tạm đã dọn sau gate. Không chạy `npm install`, không gọi Internet hoặc production; dùng dependency có sẵn và fetch mock. Chưa kiểm gửi mail thật/DNS/SMTP production vì brief yêu cầu offline.
+
+## Hoàn thành ở 0.2.1
 
 - [x] Package Node 20 + TypeScript, ESM, stdio MCP; bin `monacloud-mcp`, version `0.2.1`.
 - [x] OAuth device flow client `monacloud-mcp`, scope `offline_access`, token store private `0600`, refresh tự động; CLI `login`, `logout`, `whoami`.
@@ -55,3 +123,11 @@ CODEX DONE
 - Lưu ý test tự động: trang consent Keycloak có form action TƯƠNG ĐỐI (`/realms/mona/login-actions/consent?...`) → script phải ghép host; urllib Python rớt cookie ở hop 302 → dùng curl cookie jar.
 - Chưa: publish npm (`npm publish` — Claude làm khi deploy), `monapay_link`/`vibecloud_link` chờ endpoint link phía sản phẩm (gói E monapay, brief VIBECLOUD-MONAID đã có `/api/auth/monaid/link`).
 - 04/09: publish npm `monacloud-mcp` 0.1.0 rồi 0.1.1 (sửa dep monapay-mcp ^0.3.0 → ^0.5.5 vì 0.5.x không khớp ^0.3).
+- 04/09: sandbox bỏ spend guard (Codex) → publish 0.2.1; verify: cloud_vps_create sandbox:true với ví 0đ → job queued; không sandbox → insufficient_funds đúng.
+
+CODEX B DONE
+
+## QC Claude 05/09 (JOB B mail_*) — PASS local
+- tsc sạch · `node --test` 23/23 · 20 tool `mail_*` + prompt `gui-mail-otp-monamail` + health `monamail` trong `monacloud://status`.
+- Claude vá: `idempotencyHeaders` luôn gửi `Idempotency-Key` (mặc định `mcp-mail-<uuid>`) thay vì chỉ khi có tham số — AI retry an toàn theo contract §5.
+- Chưa publish npm 0.3.0: chờ `api.monamail.vn` live (deploy theo `handoff/DEPLOY-MONA-MAIL-RUNBOOK.md`) rồi zero-dashboard test prod bằng `handoff/tests/test_mail_zero_dashboard.py`.

package/dist/clients.d.ts

@@ -7,6 +7,12 @@ export declare class CloudClients {
     readonly fetchImpl: typeof fetch;
     constructor(config: Config, auth: AuthManager, fetchImpl?: typeof fetch);
     private billing;
+    mail<T = unknown>(path: string, options?: {
+        method?: string;
+        body?: unknown;
+        query?: Record<string, string | number | undefined>;
+        headers?: Record<string, string>;
+    }): Promise<T>;
     balance(): Promise<unknown>;
     ledger(cursor?: string, limit?: number): Promise<unknown>;
     usage(period: string, product?: string): Promise<unknown>;
@@ -19,7 +25,7 @@ export declare class CloudClients {
     }): Promise<unknown>;
     budgetGet(): Promise<unknown>;
     tokenLimit(spendLimitVnd: number, period: string, tokenId?: string): Promise<unknown>;
-    spendGuard(): Promise<JsonObject>;
+    spendGuard(requiredVnd?: number): Promise<JsonObject>;
     sandboxEnabled(requested?: boolean): boolean;
     private vibecloudToken;
     vibecloud<T = unknown>(path: string, options?: {
@@ -27,14 +33,22 @@ export declare class CloudClients {
         body?: unknown;
         query?: Record<string, string | number | undefined>;
         headers?: Record<string, string>;
+        timeoutMs?: number;
     }): Promise<T>;
     guardedVibecloud(path: string, options?: {
         method?: string;
         body?: unknown;
-    }, requestedSandbox?: boolean): Promise<unknown>;
+    }, requestedSandbox?: boolean, requiredVnd?: number): Promise<unknown>;
     vibecloudLink(): Promise<JsonObject>;
     monapayLink(): Promise<JsonObject>;
     prices(): Promise<unknown>;
     packages(): Promise<unknown>;
+    plans(): Promise<unknown>;
+    invoicePdf(invoiceId: string): Promise<{
+        invoice_id: string;
+        path: string;
+        mime_type: string;
+        size_bytes: number;
+    }>;
 }
 export {};

package/dist/clients.js

@@ -1,7 +1,10 @@
 import { randomUUID } from 'node:crypto';
+import { mkdtemp, writeFile, rm } from 'node:fs/promises';
+import { tmpdir } from 'node:os';
+import { join } from 'node:path';
 import { readLinks, writeLinks } from './auth.js';
 import { CloudError } from './errors.js';
-import { requestJson, unwrapData } from './http.js';
+import { apiError, requestJson, unwrapData } from './http.js';
 const asObject = (value) => (value && typeof value === 'object' ? value : {});
 function pickString(objects, keys) {
     for (const object of objects) {
@@ -29,6 +32,40 @@ export class CloudClients {
             fetchImpl: this.fetchImpl,
         });
     }
+    async mail(path, options = {}) {
+        try {
+            return await requestJson(`${this.config.monamailApi}${path}`, {
+                ...options,
+                headers: {
+                    ...(options.method === 'POST' ? { 'Idempotency-Key': `mcp-mail-${randomUUID()}` } : {}),
+                    ...options.headers,
+                },
+                token: await this.auth.accessToken(),
+                fetchImpl: this.fetchImpl,
+            });
+        }
+        catch (error) {
+            if (!(error instanceof CloudError) || !error.status)
+                throw error;
+            // Mail keeps the API's error contract without changing legacy HTTP errors.
+            const root = asObject(error.details);
+            const objects = [root, asObject(root.detail)];
+            const code = path === '/v1/account/plan' && error.status === 402
+                ? 'insufficient_funds'
+                : pickString(objects, ['code']) || error.code;
+            const fallback = code === 'insufficient_funds'
+                ? `Gọi cloud_topup để nạp ví, chờ cloud_balance cập nhật rồi thử lại. Console: ${this.config.consoleUrl}.`
+                : code === 'quota_exceeded'
+                    ? 'Gọi mail_plans rồi mail_plan_set để đổi gói trước khi gửi tiếp.'
+                    : code === 'budget_exceeded'
+                        ? 'Gọi cloud_budget_get và điều chỉnh ngân sách trước khi thử lại.'
+                        : error.nextStep;
+            const nextStep = pickString(objects, ['next_step']) || fallback;
+            throw new CloudError(code, pickString(objects, ['message']) || error.message, code === 'insufficient_funds' && !nextStep.includes('cloud_topup')
+                ? `${nextStep} Gọi cloud_topup để nạp ví.`
+                : nextStep, { status: error.status, details: error.details, requestId: error.requestId });
+        }
+    }
     balance() {
         return this.billing('/v1/balance');
     }
@@ -61,11 +98,14 @@ export class CloudClients {
             fetchImpl: this.fetchImpl,
         });
     }
-    async spendGuard() {
-        const current = asObject(await this.balance());
+    async spendGuard(requiredVnd) {
+        const current = asObject(unwrapData(await this.balance()));
         const balance = current.balance_vnd;
-        if (typeof balance === 'number' && balance <= 0) {
-            throw new CloudError('insufficient_funds', 'Ví thiếu tiền: số dư hiện tại là 0 đ.', `Nạp ví tại ${this.config.consoleUrl} rồi gọi lại tool.`);
+        if (requiredVnd !== undefined && (typeof balance !== 'number' || !Number.isFinite(balance))) {
+            throw new CloudError('invalid_balance', 'Không đọc được số dư để duyệt giá gói.', 'Gọi cloud_balance rồi thử lại.');
+        }
+        if (typeof balance === 'number' && (requiredVnd === undefined ? balance <= 0 : balance < requiredVnd)) {
+            throw new CloudError('insufficient_funds', `Ví thiếu tiền: có ${balance} đ${requiredVnd === undefined ? '' : `, cần ${requiredVnd} đ`}.`, `Gọi cloud_topup để nạp ví tại ${this.config.consoleUrl} rồi gọi lại tool.`);
         }
         return current;
     }
@@ -84,15 +124,16 @@ export class CloudClients {
     }
     async vibecloud(path, options = {}) {
         return requestJson(`${this.config.vibecloudApi}${path}`, {
+            timeoutMs: 30_000,
             ...options,
             token: await this.vibecloudToken(),
             fetchImpl: this.fetchImpl,
         });
     }
-    async guardedVibecloud(path, options = {}, requestedSandbox = false) {
+    async guardedVibecloud(path, options = {}, requestedSandbox = false, requiredVnd) {
         const sandbox = this.sandboxEnabled(requestedSandbox);
         if (!sandbox)
-            await this.spendGuard();
+            await this.spendGuard(requiredVnd);
         const result = await this.vibecloud(path, {
             ...options,
             ...(sandbox ? { headers: { 'X-Vibecloud-Sandbox': '1' } } : {}),
@@ -167,4 +208,46 @@ export class CloudClients {
     packages() {
         return requestJson(`${this.config.vibecloudApi}/api/packages`, { fetchImpl: this.fetchImpl });
     }
+    plans() {
+        return requestJson(`${this.config.vibecloudApi}/api/plans`, { fetchImpl: this.fetchImpl });
+    }
+    async invoicePdf(invoiceId) {
+        const token = await this.vibecloudToken();
+        let response;
+        try {
+            response = await this.fetchImpl(`${this.config.vibecloudApi}/api/invoices/${encodeURIComponent(invoiceId)}.pdf`, {
+                headers: { Authorization: `Bearer ${token}`, Accept: 'application/pdf' },
+                signal: AbortSignal.timeout(30_000),
+                redirect: 'error',
+            });
+        }
+        catch {
+            throw new CloudError('network_error', 'Không tải được PDF hoá đơn.', 'Gọi lại cloud_invoice_pdf với cùng invoice_id.');
+        }
+        if (!response.ok) {
+            const body = await response.text();
+            let parsed;
+            try {
+                parsed = JSON.parse(body);
+            }
+            catch {
+                parsed = { message: body.slice(0, 1000) };
+            }
+            throw apiError(response, parsed);
+        }
+        const bytes = Buffer.from(await response.arrayBuffer());
+        if (bytes.subarray(0, 5).toString('ascii') !== '%PDF-') {
+            throw new CloudError('invalid_pdf', 'API không trả nội dung PDF hợp lệ.', 'Kiểm tra invoice_id rồi thử lại.');
+        }
+        const directory = await mkdtemp(join(tmpdir(), 'monacloud-invoice-'));
+        const path = join(directory, 'invoice.pdf');
+        try {
+            await writeFile(path, bytes, { mode: 0o600, flag: 'wx' });
+        }
+        catch (error) {
+            await rm(directory, { recursive: true, force: true });
+            throw error;
+        }
+        return { invoice_id: invoiceId, path, mime_type: 'application/pdf', size_bytes: bytes.length };
+    }
 }

package/dist/compute.d.ts

@@ -0,0 +1,18 @@
+import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import type { CloudClients } from './clients.js';
+type Row = Record<string, unknown>;
+export declare const APP_FLOW = "Khi user n\u00F3i \"deploy repo\", d\u00F9ng cloud_app_create (app t\u1EEB git \u0111\u00E3 live: repo public \u2192 URL https). \u0110\u1ECDc cloud_app_host_list, cloud_prices/cloud_packages v\u00E0 cloud_balance; n\u1EBFu ch\u01B0a c\u00F3 app host th\u00EC cloud_app_create sandbox=true tr\u01B0\u1EDBc \u0111\u1EC3 l\u1EA5y \u01B0\u1EDBc t\u00EDnh. \u0110\u1ECDc \u2192 \u01B0\u1EDBc t\u00EDnh VND \u2192 h\u1ECFi duy\u1EC7t n\u1EBFu ch\u01B0a \u0111\u01B0\u1EE3c duy\u1EC7t \u2192 l\u00E0m th\u1EADt \u2192 poll t\u1EDBi done/succeeded \u2192 ki\u1EC3m URL. Kh\u00F4ng g\u1ECDi agent_deploy cho repo git. / Deploy a repository with cloud_app_create; inspect, estimate, obtain approval, then deploy.";
+export declare function rows(value: unknown, key: string): Row[];
+export declare function planEstimate(clients: CloudClients, code: string, cycle?: string): Promise<{
+    plan: Row;
+    estimate: {
+        billing_mode: string;
+        plan_code: string;
+        period: string;
+        amount_vnd: number;
+        currency: string;
+    };
+}>;
+export declare function createVps(clients: CloudClients, body: Row): Promise<unknown>;
+export declare function registerComputeTools(server: McpServer, clients: CloudClients): void;
+export {};

package/dist/compute.js

@@ -0,0 +1,102 @@
+import { z } from 'zod';
+import { CloudError, runTool } from './errors.js';
+import { unwrapData } from './http.js';
+import { finishAppJob } from './jobs.js';
+export const APP_FLOW = 'Khi user nói "deploy repo", dùng cloud_app_create (app từ git đã live: repo public → URL https). Đọc cloud_app_host_list, cloud_prices/cloud_packages và cloud_balance; nếu chưa có app host thì cloud_app_create sandbox=true trước để lấy ước tính. Đọc → ước tính VND → hỏi duyệt nếu chưa được duyệt → làm thật → poll tới done/succeeded → kiểm URL. Không gọi agent_deploy cho repo git. / Deploy a repository with cloud_app_create; inspect, estimate, obtain approval, then deploy.';
+const sandbox = z.boolean().optional().describe('Thử 0đ, không tạo hạ tầng thật / Sandbox, no charge');
+const id = z.string().trim().min(1).max(255);
+const planCode = z.string().trim().min(2).max(64);
+const period = z.enum(['month', 'year']);
+const object = (value) => value && typeof value === 'object' ? value : {};
+export function rows(value, key) {
+    const data = unwrapData(value);
+    const list = Array.isArray(data) ? data : object(data)[key];
+    return Array.isArray(list) ? list.filter((row) => row && typeof row === 'object') : [];
+}
+export async function planEstimate(clients, code, cycle = 'month') {
+    const plan = rows(await clients.plans(), 'plans').find((row) => row.code === code && row.active !== false);
+    if (!plan)
+        throw new CloudError('plan_not_found', `Không có gói đang mở: ${code}.`, 'Gọi cloud_plan_list để chọn plan_code.');
+    const amount = plan[cycle === 'year' ? 'price_year_vnd' : 'price_month_vnd'];
+    if (typeof amount !== 'number' || !Number.isFinite(amount) || amount < 0) {
+        throw new CloudError('invalid_plan_price', 'Không đọc được giá gói.', 'Gọi cloud_plan_list rồi thử lại; không tự đoán giá.');
+    }
+    return { plan, estimate: { billing_mode: 'monthly', plan_code: code, period: cycle, amount_vnd: amount, currency: 'VND' } };
+}
+export async function createVps(clients, body) {
+    const { sandbox: requested, ...payload } = body;
+    if (payload.billing_mode !== 'monthly')
+        return clients.guardedVibecloud('/api/lxc', { method: 'POST', body: payload }, requested === true);
+    const { plan, estimate } = await planEstimate(clients, String(payload.plan_code), String(payload.period || 'month'));
+    // Wave A rejects mixed sizing. Strip all hourly sizing before the real request.
+    delete payload.cpu;
+    delete payload.ram_gb;
+    delete payload.disk_gb;
+    delete payload.package_slug;
+    const isSandbox = clients.sandboxEnabled(requested === true);
+    const outgoing = isSandbox
+        ? { app_name: payload.app_name, cpu: plan.cpu, ram_gb: plan.ram_gb, disk_gb: plan.disk_gb }
+        : payload;
+    const result = await clients.guardedVibecloud('/api/lxc', { method: 'POST', body: outgoing }, isSandbox, estimate.amount_vnd);
+    return { ...object(result), estimate, ...(isSandbox ? {
+            preview_billing_mode: 'hourly', requested_billing_mode: 'monthly',
+            next_step: 'Sandbox chỉ thử cấu hình gói qua hourly (0đ); chưa tạo subscription. Duyệt giá estimate rồi gọi cloud_vps_create billing_mode=monthly, sandbox=false.',
+        } : {}) };
+}
+export function registerComputeTools(server, clients) {
+    // Every new compute tool keeps a mechanical legacy alias, using the same schema and handler.
+    const register = (name, description, schema, handler) => {
+        for (const toolName of [name, name.replace(/^cloud_/, 'vibecloud_')]) {
+            server.registerTool(toolName, {
+                description: toolName === name ? description : `Alias tương thích của ${name}. / Compatibility alias. ${description}`,
+                inputSchema: schema,
+            }, (args) => runTool(() => handler(args)));
+        }
+    };
+    register('cloud_plan_list', 'Bảng gói cùng giá tháng/năm; gợi ý gói rẻ nhất đủ CPU/RAM/đĩa yêu cầu, admin_only không tự chọn. Đọc trước khi duyệt chi phí. / List plans, prices and sizing recommendation.', z.object({ cpu: z.number().int().positive().optional(), ram_gb: z.number().positive().optional(), disk_gb: z.number().positive().optional() }).strict(), async (needs) => {
+        const plans = rows(await clients.plans(), 'plans');
+        const eligible = plans.filter((plan) => plan.active !== false && !plan.admin_only
+            && ['cpu', 'ram_gb', 'disk_gb'].every((key) => typeof plan[key] === 'number' && Number(plan[key]) >= (needs[key] || 0))
+            && typeof plan.price_month_vnd === 'number').sort((a, b) => Number(a.price_month_vnd) - Number(b.price_month_vnd));
+        return { plans, recommendation: eligible[0] ? { plan_code: eligible[0].code, reason: 'Gói giá tháng thấp nhất đáp ứng cấu hình yêu cầu; kiểm tra tải thực tế, backup và included_db.' } : null,
+            next_step: 'Chọn plan_code và month/year, báo giá tương ứng rồi hỏi duyệt trước cloud_vps_create.' };
+    });
+    register('cloud_subscription_list', 'Đọc các gói đang dùng, kỳ gia hạn và auto-renew. / List subscriptions.', z.object({}).strict(), () => clients.vibecloud('/api/subscriptions'));
+    register('cloud_subscription_update', 'Đổi gói/chu kỳ/gia hạn sau khi đọc subscription và giá, ước tính rồi được duyệt. Upgrade tính prorate, downgrade kỳ sau. Huỷ: auto_renew=false, cancel_action=hourly|stop. / Update or cancel renewal.', z.object({ service_id: id, plan_code: planCode.optional(), period: period.optional(), auto_renew: z.boolean().optional(), cancel_action: z.enum(['hourly', 'stop']).optional() }).strict()
+        .refine((args) => [args.plan_code, args.period, args.auto_renew, args.cancel_action].some((value) => value !== undefined), 'Cần ít nhất một thay đổi subscription.'), async ({ service_id, ...body }) => {
+        // Cancellation must remain possible with an empty wallet. Proration is authoritative at the API.
+        return clients.vibecloud(`/api/services/${encodeURIComponent(service_id)}/subscription`, { method: 'POST', body });
+    });
+    register('cloud_invoice_list', 'Đọc hoá đơn hàng tháng của tài khoản. / List monthly invoices.', z.object({}).strict(), () => clients.vibecloud('/api/invoices'));
+    register('cloud_invoice_pdf', 'Tải PDF hoá đơn vào file tạm riêng tư, trả path; sao chép ra nơi cần giữ trước khi hệ điều hành dọn. / Download invoice PDF to a private temporary file.', z.object({ invoice_id: id }).strict(), ({ invoice_id }) => clients.invoicePdf(invoice_id));
+    register('cloud_credit_redeem', 'Dùng mã credit người dùng cung cấp sau khi họ đồng ý; không thử đoán mã. / Redeem an approved promotional credit code.', z.object({ code: z.string().trim().min(2).max(64) }).strict(), ({ code }) => clients.vibecloud('/api/credit-codes/redeem', { method: 'POST', body: { code: code.toUpperCase() } }));
+    const appNotice = 'App từ git đã live: app host đầu tiên ~2–3 phút, deploy sau đó 10–20 giây. / Git apps are live. ';
+    const poll = { wait: z.boolean().default(true), interval_sec: z.number().int().min(1).max(30).default(3), timeout_sec: z.number().int().min(1).max(600).default(600) };
+    const env = z.record(z.string().regex(/^[A-Za-z_][A-Za-z0-9_]*$/), z.string().refine((value) => !value.includes('\0'), 'Env không chứa NUL.')).refine((value) => Object.keys(value).length <= 200 && Object.entries(value).reduce((sum, [key, val]) => sum + key.length + val.length, 0) <= 65536, 'Env tối đa 200 key / 64 KiB.');
+    const domain = z.string().trim().min(3).max(253).regex(/^(?:[a-zA-Z0-9](?:[a-zA-Z0-9-]{0,61}[a-zA-Z0-9])?\.)+[a-zA-Z]{2,63}$/, 'Chỉ hostname, không URL/path.');
+    const appId = z.object({ app_id: id, sandbox }).strict();
+    const gitPath = z.string().trim().min(1).max(255).refine((value) => !/[\x00-\x1f]/.test(value) && !value.startsWith('-') && !value.startsWith('/') && !value.split('/').includes('..'), 'Nhánh/path git không hợp lệ.');
+    const repo = z.string().trim().min(1).max(2048).refine((value) => {
+        try {
+            const u = new URL(value);
+            return u.protocol === 'https:' && !u.port && !u.password && !u.username && !u.search && !u.hash && u.pathname.length > 1;
+        }
+        catch {
+            return false;
+        }
+    }, 'Dùng public HTTPS git URL không chứa token/mật khẩu; private repo chưa được hỗ trợ.');
+    const compute = async (path, options, requested) => {
+        const isSandbox = clients.sandboxEnabled(requested);
+        const result = await clients.vibecloud(path, { ...options, ...(isSandbox ? { headers: { 'X-Vibecloud-Sandbox': '1' } } : {}) });
+        return isSandbox ? { ...(Array.isArray(result) ? { items: result } : object(result)), sandbox: true } : result;
+    };
+    register('cloud_app_create', appNotice + APP_FLOW, z.object({ repo_url: repo, branch: gitPath.default('main'), build_type: z.enum(['dockerfile', 'nixpacks', 'static']).default('dockerfile'), dockerfile: gitPath.default('Dockerfile'), env: env.default({}), domain: domain.optional(), app_host_id: id.optional(), port: z.number().int().min(1).max(65535).default(3000), sandbox, ...poll }).strict(), async ({ sandbox: requested, wait, interval_sec, timeout_sec, ...body }) => finishAppJob(clients, await clients.guardedVibecloud('/api/apps', { method: 'POST', body }, requested), clients.sandboxEnabled(requested), wait, interval_sec, timeout_sec));
+    register('cloud_app_list', appNotice + 'Liệt kê app trước khi tạo để tránh trùng. / List apps.', z.object({ sandbox }).strict(), ({ sandbox }) => compute('/api/apps', {}, sandbox));
+    register('cloud_app_host_list', appNotice + 'Đọc app host; chưa có host thì sandbox cloud_app_create trước để ước tính. / List app hosts.', z.object({ sandbox }).strict(), ({ sandbox }) => compute('/api/app-hosts', {}, sandbox));
+    register('cloud_app_get', appNotice + 'Đọc status, URL, lần deploy và app host. / Inspect app.', appId, ({ app_id, sandbox }) => compute(`/api/apps/${encodeURIComponent(app_id)}`, {}, sandbox));
+    register('cloud_app_deploy', appNotice + 'Deploy lại sau khi đọc app/log và được duyệt; poll job tới kết quả. / Redeploy and poll.', appId.extend(poll), async ({ app_id, sandbox, wait, interval_sec, timeout_sec }) => finishAppJob(clients, await clients.guardedVibecloud(`/api/apps/${encodeURIComponent(app_id)}/deploy`, { method: 'POST' }, sandbox), clients.sandboxEnabled(sandbox), wait, interval_sec, timeout_sec));
+    register('cloud_app_env_set', appNotice + 'Thay toàn bộ env sau khi được duyệt, gửi đầy đủ map cần giữ; không log secret. Gọi cloud_app_deploy sau đó để áp dụng. / Set app environment.', appId.extend({ env }), ({ app_id, env, sandbox }) => compute(`/api/apps/${encodeURIComponent(app_id)}/env`, { method: 'PUT', body: { env } }, sandbox));
+    register('cloud_app_domain_add', appNotice + 'Thêm domain đã được duyệt, trả hướng dẫn CNAME từ API; chờ DNS trước kiểm HTTPS. / Attach custom domain.', appId.extend({ host: domain }), ({ app_id, host, sandbox }) => compute(`/api/apps/${encodeURIComponent(app_id)}/domains`, { method: 'POST', body: { host } }, sandbox));
+    register('cloud_app_logs', appNotice + 'Đọc tối đa 500 dòng log; có thể chứa secret, không đưa nguyên log ra công khai. / Read deployment logs.', appId.extend({ deployment: id.optional() }), ({ app_id, deployment, sandbox }) => compute(`/api/apps/${encodeURIComponent(app_id)}/logs`, { query: { deployment } }, sandbox));
+    register('cloud_app_delete', appNotice + 'Sau khi user duyệt xoá: xoá app/domain/A record; app host vẫn có thể tính phí. / Delete an approved app.', appId, ({ app_id, sandbox }) => compute(`/api/apps/${encodeURIComponent(app_id)}`, { method: 'DELETE' }, sandbox));
+}

package/dist/config.d.ts

@@ -2,6 +2,7 @@ export type Config = {
     issuer: string;
     billingUrl: string;
     monapayApi: string;
+    monamailApi: string;
     vibecloudApi: string;
     consoleUrl: string;
     clientId: string;

package/dist/config.js

@@ -8,6 +8,7 @@ export function readConfig(env = process.env) {
         issuer: cleanBaseUrl(env.MONACLOUD_ISSUER || 'https://pass.monacloud.vn/realms/mona'),
         billingUrl: cleanBaseUrl(env.MONACLOUD_BILLING_URL || 'https://billing.monacloud.vn'),
         monapayApi: cleanBaseUrl(env.MONAPAY_API || env.MONAPAY_BASE_URL || 'https://api.monapay.vn'),
+        monamailApi: cleanBaseUrl(env.MONAMAIL_API || 'https://api.monamail.vn'),
         vibecloudApi: cleanBaseUrl(env.MONACLOUD_API || env.VIBECLOUD_API || env.VIBECLOUD_API_URL || 'https://api.monacloud.vn'),
         consoleUrl: cleanBaseUrl(env.MONACLOUD_CONSOLE_URL || 'https://monacloud.vn/console'),
         clientId: env.MONACLOUD_CLIENT_ID || 'monacloud-mcp',

package/dist/http.d.ts

@@ -1,3 +1,4 @@
+import { CloudError } from './errors.js';
 export type HttpOptions = {
     method?: string;
     token?: string;
@@ -7,5 +8,6 @@ export type HttpOptions = {
     fetchImpl?: typeof fetch;
     timeoutMs?: number;
 };
+export declare function apiError(response: Response, body: unknown): CloudError;
 export declare function requestJson<T = unknown>(url: string, options?: HttpOptions): Promise<T>;
 export declare function unwrapData<T = unknown>(value: unknown): T;

package/dist/http.js

@@ -8,7 +8,7 @@ const nestedString = (body, key) => {
     const nested = detail[key];
     return typeof nested === 'string' && nested ? nested : undefined;
 };
-function apiError(response, body) {
+export function apiError(response, body) {
     const parsed = asRecord(body);
     const requestId = response.headers.get('x-request-id')
         || nestedString(parsed, 'request_id');

package/dist/index.js

@@ -22,7 +22,7 @@ async function main() {
         return;
     }
     if (command === '--version' || command === '-v') {
-        console.log('0.2.1');
+        console.log('0.3.0');
         return;
     }
     if (command === '--help' || command === '-h' || command === 'help') {

package/dist/jobs.d.ts

@@ -0,0 +1,11 @@
+import type { CloudClients } from './clients.js';
+export declare const TERMINAL_JOBS: Set<string>;
+export declare function pollJob(clients: CloudClients, jobId: string, wait: boolean, intervalSeconds: number, timeoutSeconds: number, sandbox: boolean): Promise<Record<string, unknown>>;
+export declare function finishAppJob(clients: CloudClients, created: unknown, sandbox: boolean, wait: boolean, interval: number, timeout: number): Promise<{
+    job_id?: string | undefined;
+    estimate?: {} | undefined;
+    app_id?: string | undefined;
+    url?: string | undefined;
+    application_id?: string | undefined;
+    sandbox?: boolean | undefined;
+}>;