monacloud-mcp 0.9.2 → 0.10.1

package/README.md

@@ -150,6 +150,25 @@ Mỗi tool có alias `vibecloud_base_*` cùng schema và handler. Cần DB/Supab
 
 `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 Domain — tên miền cho app (monadomain.vn)
+
+AI tra tên, báo giá VND đã VAT, hỏi chủ thể, mua .vn/.com bằng ví MONA Cloud rồi trỏ DNS + SSL vào app. Tra giá **không cần đăng nhập**; người dùng chưa có tài khoản vẫn mua được trong phiên bằng đường giữ chỗ → quét QR → bấm claim (đăng nhập MONA Pass 1 bước = tạo ví = mua).
+
+| Tool | Công dụng |
+|---|---|
+| `cloud_domain_search` | Còn trống + giá theo TLD; **guest gọi được** |
+| `cloud_domain_reserve` | Giữ chỗ 30' không trừ tiền; hỏi email + sđt (+ opt-in ưu đãi); trả QR đúng giá + `claim_url` + `claim_token`/`guest_token` |
+| `cloud_domain_reserve_status` | reserved / paid / claimed / expired + `next_step` |
+| `cloud_domain_claim` | Đăng nhập Pass → nhận reservation, kéo tiền về ví, mua ngay (idempotent) |
+| `cloud_domain_reserve_release` | Nhả chỗ khi chưa có tiền vào |
+| `cloud_domain_registrant_get` / `cloud_domain_registrant_set` | Chủ thể đăng ký (.vn cá nhân cần CCCD, tổ chức cần MST) |
+| `cloud_domain_buy` | Mua thẳng bằng ví khi đã đăng nhập; 402 → `cloud_topup` in QR |
+| `cloud_domain_verify_start` / `cloud_domain_verify_status` / `cloud_domain_wait` | Hồ sơ .vn + chờ active |
+| `cloud_domain_renew` | Gia hạn: dry_run báo giá → duyệt → trừ ví VND |
+| `cloud_domain_dns_*` / `cloud_domain_ns_set` / `cloud_domain_attach` / `cloud_domain_health` | DNS, NS, gắn app, sức khoẻ |
+
+Giữ chỗ chỉ khoá tên trong hệ MONA Cloud (`hold_scope=monacloud`), không giữ ở registry — tên đẹp thì trả sớm. Không gọi registrar tới khi tiền vào và có tài khoản nhận. Prompt `mua-ten-mien-monacloud(keyword?, app_id?)` dẫn trọn luồng.
+
 ### 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.

package/dist/clients.d.ts

@@ -44,6 +44,18 @@ export declare class CloudClients {
         headers?: Record<string, string>;
         timeoutMs?: number;
     }): Promise<T>;
+    /**
+     * Gọi endpoint MONA Cloud mở cho guest (spec monadomain §12: search/reserve/status không cần Pass).
+     * Có token trên máy thì vẫn gửi (để backend ghi lead + gắn chủ); chưa login thì đi ẩn danh
+     * hoặc dùng guest_token của reservation — KHÔNG ném login_required.
+     */
+    vibecloudGuestOk<T = unknown>(path: string, options?: {
+        method?: string;
+        body?: unknown;
+        query?: Record<string, string | number | undefined>;
+        headers?: Record<string, string>;
+        guestToken?: string;
+    }): Promise<T>;
     guardedVibecloud(path: string, options?: {
         method?: string;
         body?: unknown;

package/dist/clients.js

@@ -222,6 +222,29 @@ export class CloudClients {
             fetchImpl: this.fetchImpl,
         });
     }
+    /**
+     * Gọi endpoint MONA Cloud mở cho guest (spec monadomain §12: search/reserve/status không cần Pass).
+     * Có token trên máy thì vẫn gửi (để backend ghi lead + gắn chủ); chưa login thì đi ẩn danh
+     * hoặc dùng guest_token của reservation — KHÔNG ném login_required.
+     */
+    async vibecloudGuestOk(path, options = {}) {
+        const { guestToken, ...rest } = options;
+        let token;
+        try {
+            token = await this.vibecloudToken();
+        }
+        catch (error) {
+            if (!(error instanceof CloudError) || error.code !== 'login_required')
+                throw error;
+            token = guestToken;
+        }
+        return requestJson(`${this.config.vibecloudApi}${path}`, {
+            timeoutMs: 30_000,
+            ...rest,
+            token,
+            fetchImpl: this.fetchImpl,
+        });
+    }
     async guardedVibecloud(path, options = {}, requestedSandbox = false, requiredVnd) {
         const sandbox = this.sandboxEnabled(requestedSandbox);
         if (!sandbox)

package/dist/domains.js

@@ -25,7 +25,7 @@ const registrantSchema = z.object({
 export function registerDomainTools(server, clients) {
     server.registerTool('cloud_domain_search', {
         title: 'Tìm kiếm + báo giá tên miền',
-        description: 'Kiểm tra tên miền còn trống và xem giá mua. Dùng trước khi mua để AI biết available/price.',
+        description: 'Kiểm tra tên miền còn trống và xem giá mua (VND, đã VAT). KHÔNG cần đăng nhập MONA Pass — gọi được ngay cả khi người dùng chưa có tài khoản; dùng trước khi mua/giữ chỗ để biết available/price.',
         inputSchema: z.object({
             q: z.string().min(1).max(253).describe('Tên miền hoặc từ khoá (vd: "myapp" hoặc "myapp.vn").'),
             tlds: z.string().max(200).optional().describe('Đuôi muốn tìm, phân cách phẩy (vd: "vn,com"). Mặc định: vn,com.'),
@@ -37,7 +37,7 @@ export function registerDomainTools(server, clients) {
             params.set('tlds', tlds);
         if (years)
             params.set('years', String(years));
-        return clients.vibecloud(`/api/domains/search?${params}`);
+        return clients.vibecloudGuestOk(`/api/domains/search?${params}`);
     }));
     server.registerTool('cloud_domain_registrant_get', {
         title: 'Xem thông tin chủ thể đăng ký tên miền',
@@ -81,6 +81,63 @@ export function registerDomainTools(server, clients) {
             body.registrant_id = registrant_id;
         return clients.guardedVibecloud('/api/domains', { method: 'POST', body }, sandbox === true);
     }));
+    // --- Guest → reserve → claim (spec monadomain §12): mua TRƯỚC khi có tài khoản ---------------
+    server.registerTool('cloud_domain_reserve', {
+        title: 'Giữ chỗ tên miền + QR trả tiền (không cần tài khoản)',
+        description: [
+            'Giữ chỗ tên miền 30 phút cho người dùng CHƯA có MONA Pass (hoặc chưa login trên máy này) — không trừ tiền, không đăng ký thật, chỉ khoá tên trong hệ MONA Cloud.',
+            'Dùng khi người dùng muốn mua ngay trong phiên mà không muốn "đi đăng ký" trước: bạn đã dựng app, chọn tên, chỉ cần người bấm.',
+            'Bắt buộc hỏi người dùng: tên miền (xác nhận chính tả → spelling_confirmed), email, số điện thoại (kênh nhận link claim + hoá đơn). Hỏi thêm 1 câu nhẹ: "nhận thông báo ưu đãi MONA Cloud không?" → marketing_consent; không tick thì để false.',
+            'Nếu người dùng đã đưa đủ thông tin chủ thể (.vn cần CCCD/MST) thì gửi luôn ở registrant — lúc claim khỏi hỏi lại.',
+            'Kết quả: payment.qr_url (QR VietQR đúng số tiền) + claim_url + claim_token + guest_token (giữ lại để gọi cloud_domain_reserve_status). Đưa QR cho người dùng quét NGAY; tiền vào → hệ giữ cho reservation này. Sau đó người dùng mở claim_url: đăng nhập/đăng ký MONA Pass (Google/GitHub/email, 1 bước) → hệ tự lấy tiền + mua + tạo ví. Nếu người dùng ĐÃ có Pass trên máy này thì gọi thẳng cloud_domain_claim.',
+            'Giữ chỗ chỉ trong hệ MONA Cloud (hold_scope=monacloud) — người ngoài vẫn có thể đăng ký tên đó ở registry khác trong 30 phút; nói rõ điều này nếu tên đẹp.',
+        ].join(' '),
+        inputSchema: z.object({
+            name: domainName,
+            years: z.number().int().min(1).max(10).optional().describe('Số năm đăng ký. Mặc định 1.'),
+            email: z.string().email().describe('Email người dùng — nhận claim_url + hoá đơn.'),
+            phone: z.string().min(8).max(20).describe('Số điện thoại người dùng.'),
+            spelling_confirmed: z.boolean().describe('true = người dùng đã xác nhận chính tả tên miền.'),
+            marketing_consent: z.boolean().optional().describe('true CHỈ KHI người dùng đồng ý nhận thông báo ưu đãi MONA Cloud. Mặc định false.'),
+            registrant: registrantSchema.optional().describe('Thông tin chủ thể nếu đã hỏi được đủ trong phiên (tuỳ chọn).'),
+            context: z.string().max(500).optional().describe('Ngữ cảnh ngắn (vd: "Cursor dựng shop Next.js") — giúp MONA hỗ trợ đúng.'),
+            sandbox: z.boolean().optional().describe('sandbox=true: giả lập, không tạo QR thật.'),
+        }).strict(),
+    }, ({ sandbox, ...body }) => runTool(() => clients.vibecloudGuestOk('/api/domains/reserve', {
+        method: 'POST',
+        body,
+        ...(clients.sandboxEnabled(sandbox === true) ? { headers: { 'X-Vibecloud-Sandbox': '1' } } : {}),
+    })));
+    server.registerTool('cloud_domain_reserve_status', {
+        title: 'Trạng thái giữ chỗ tên miền',
+        description: 'Xem reservation đã nhận tiền chưa / đã claim chưa / còn hạn không. Guest truyền claim_token (hoặc guest_token) nhận từ cloud_domain_reserve; chủ reservation đã login thì không cần. Đọc next_step trong kết quả để biết bước kế.',
+        inputSchema: z.object({
+            reservation_id: objectId.describe('ID reservation từ cloud_domain_reserve.'),
+            claim_token: z.string().min(16).max(128).optional().describe('claim_token hoặc guest_token từ cloud_domain_reserve (bắt buộc khi chưa login).'),
+        }).strict(),
+    }, ({ reservation_id, claim_token }) => runTool(() => clients.vibecloudGuestOk(`/api/domains/reserve/${encodeURIComponent(reservation_id)}`, { query: claim_token ? { t: claim_token } : undefined, guestToken: claim_token })));
+    server.registerTool('cloud_domain_claim', {
+        title: 'Nhận reservation về tài khoản + mua (claim = đăng ký = trả tiền)',
+        description: [
+            'Gắn reservation vào MONA Pass đang đăng nhập, kéo tiền đã chuyển (nếu có) về ví rồi MUA ngay. Cần đăng nhập (monacloud-mcp login) — lần đầu đăng nhập MONA Cloud tự tạo hồ sơ + ví, không có form đăng ký riêng.',
+            'Idempotent: gọi lại khi trả 402 (ví chưa đủ → cloud_topup hoặc chờ tiền QR vào) hoặc 422 registrant_required (→ cloud_domain_registrant_set rồi claim lại; tiền vẫn nằm trong ví).',
+            'Kết quả như cloud_domain_buy (order id, status, suggested_next).',
+        ].join(' '),
+        inputSchema: z.object({
+            reservation_id: objectId.describe('ID reservation từ cloud_domain_reserve.'),
+            claim_token: z.string().min(16).max(128).describe('claim_token từ cloud_domain_reserve (hoặc tham số t trong claim_url).'),
+            registrant_id: objectId.optional().describe('ID registrant muốn dùng (mặc định: registrant của user hoặc từ reservation).'),
+            marketing_consent: z.boolean().optional().describe('true nếu người dùng đồng ý nhận ưu đãi lúc này.'),
+        }).strict(),
+    }, ({ reservation_id, ...body }) => runTool(() => clients.vibecloud(`/api/domains/reserve/${encodeURIComponent(reservation_id)}/claim`, { method: 'POST', body })));
+    server.registerTool('cloud_domain_reserve_release', {
+        title: 'Nhả chỗ tên miền đã giữ',
+        description: 'Huỷ reservation chưa nhận tiền (người dùng đổi ý / chọn tên khác). Đã có tiền vào thì không huỷ được — dùng cloud_domain_claim.',
+        inputSchema: z.object({
+            reservation_id: objectId,
+            claim_token: z.string().min(16).max(128).optional().describe('Bắt buộc khi chưa login.'),
+        }).strict(),
+    }, ({ reservation_id, claim_token }) => runTool(() => clients.vibecloudGuestOk(`/api/domains/reserve/${encodeURIComponent(reservation_id)}`, { method: 'DELETE', query: claim_token ? { t: claim_token } : undefined, guestToken: claim_token })));
     server.registerTool('cloud_domain_list', {
         title: 'Danh sách tên miền đã import/mua',
         description: 'Liệt kê tên miền đã đưa vào MONA Cloud (import + mua). sandbox=true → xem domain sandbox.',
@@ -114,6 +171,18 @@ export function registerDomainTools(server, clients) {
             id: objectId.describe('Order ID tên miền cần kiểm tra.'),
         }).strict(),
     }, ({ id }) => runTool(() => clients.vibecloud(`/api/domains/${encodeURIComponent(id)}/health`)));
+    server.registerTool('cloud_domain_renew', {
+        title: 'Gia hạn tên miền (trừ ví VND)',
+        description: [
+            'Gia hạn tên miền đã mua qua MONA Cloud. LUÔN gọi dry_run=true trước để lấy price_vnd (đã VAT), HỎI người dùng duyệt số tiền, rồi gọi lại dry_run=false — lúc đó trừ ví VND và gia hạn thật ở registrar.',
+            '402 insufficient_balance → cloud_topup in QR cho người dùng quét, chờ paid rồi gọi lại. 502 retryable → tiền đang giữ chờ đối soát, đừng gọi lại liên tục; báo người dùng.',
+        ].join(' '),
+        inputSchema: z.object({
+            id: objectId.describe('Order ID tên miền (từ cloud_domain_list / cloud_domain_buy).'),
+            billing_cycle: z.number().int().min(12).max(120).describe('Số tháng gia hạn, bội số 12 (12 = 1 năm).'),
+            dry_run: z.boolean().optional().describe('true = chỉ báo giá, không trừ tiền. Mặc định true để an toàn.'),
+        }).strict(),
+    }, ({ id, billing_cycle, dry_run }) => runTool(() => clients.guardedVibecloud(`/api/domains/${encodeURIComponent(id)}/renew`, { method: 'POST', body: { billing_cycle, dry_run: dry_run !== false } }, false)));
     server.registerTool('cloud_domain_wait', {
         title: 'Chờ tên miền active',
         description: 'Long-poll cho đến khi tên miền chuyển sang active/failed (mặc định timeout=60s). Dùng sau cloud_domain_buy để chờ MONA Host xử lý.',
@@ -207,6 +276,7 @@ export function registerDomainTools(server, clients) {
 3. cloud_domain_registrant_set: HỎI TÔI thông tin chủ thể ngay trong phiên — họ tên, email, điện thoại, địa chỉ; nếu là .vn cá nhân hỏi thêm CCCD 12 số + ngày sinh + giới tính (tổ chức: tên công ty + MST + người đại diện). Đừng tự bịa.
 4. Kiểm ví bằng cloud_balance. Nếu thiếu tiền, gọi cloud_topup rồi IN NGUYÊN KHỐI qr_ascii (QR VietQR) cho tôi quét bằng app ngân hàng ngay trong terminal; chờ cloud_topup_status=paid.
 5. cloud_domain_buy (spelling_confirmed=true) — trừ ví, mua thật.
+   ⚠️ Nếu tôi CHƯA có tài khoản MONA Pass / tool trả login_required: KHÔNG bảo tôi đi đăng ký trước. Dùng cloud_domain_reserve (hỏi email + sđt, hỏi 1 câu "nhận ưu đãi MONA Cloud không?") → đưa tôi QR trong payment để quét trả tiền ngay + claim_url để tôi bấm đăng nhập 1 bước (Google/GitHub/email) → hệ tự tạo ví + mua. Theo dõi bằng cloud_domain_reserve_status; nếu tôi đã login trên máy này thì gọi cloud_domain_claim.
 6. Nếu là .vn: cloud_domain_verify_start đưa tôi link eKYC/bản khai (chụp CCCD + chân dung / ký), rồi cloud_domain_wait tới khi active.
 7. ${app_id ? `Gắn vào app ${app_id} bằng cloud_domain_attach` : 'Gợi ý tôi deploy app lên MONA Cloud (cloud_app_create) rồi gắn domain bằng cloud_domain_attach'} — trỏ DNS + SSL tự động.
 Trả VND, không cần thẻ quốc tế, không mở dashboard.`,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "monacloud-mcp",
-  "version": "0.9.2",
+  "version": "0.10.1",
   "description": "MCP server for MONA Cloud — deploy apps (Vercel alternative), Supabase-compatible Postgres/Auth/Storage bases (Supabase alternative), VND wallet, MONA Pay & Mail — for AI agents (Claude, Cursor, Codex) in Vietnam.",
   "license": "MIT",
   "homepage": "https://monacloud.vn",