monacloud-mcp 0.4.2 → 0.5.0

package/README.md

@@ -1,9 +1,13 @@
 # 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, gửi email giao dịch bằng MONA Mail 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ạo Base beta thay Supabase, 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 đă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.
 
+## 0.5.0 — MONA Base beta
+
+Thêm `cloud_base_create/list/get/delete/credentials` cùng alias `vibecloud_base_*`. Base thay Supabase, chung MONA Pass/ví MONA Cloud và khớp app deploy. Sandbox chỉ ước tính, không provision; chờ Base provision-live trước khi publish package.
+
 ## 0.4.0 — Đưa thư mục hiện tại lên web
 
 Prompt Claude Code: **“Đưa dự án này lên MONA Cloud, dùng thư mục hiện tại”**.
@@ -122,6 +126,19 @@ Các tên cũ như `monapay_create_qr`, `monapay_link_bank_start`, `monapay_crea
 | `cloud_prices` / `cloud_packages` | Đơn giá và gói cấu hình |
 | `cloud_agent_deploy` | Stub có cấu trúc cho runtime MONA Agent wave sau |
 
+### MONA Base (beta)
+
+Base thay Supabase, dùng chung MONA Pass và ví MONA Cloud, đồng thời khớp với app deploy. Sandbox chỉ trả URL thử và ước tính, không tạo hạ tầng thật.
+
+| Tool | Công dụng |
+|---|---|
+| `cloud_base_create` | Tạo Base, tự poll job và trả `base_id`, `studio_url`, `api_url`, `status` |
+| `cloud_base_list` / `cloud_base_get` | Liệt kê hoặc đọc trạng thái Base |
+| `cloud_base_credentials` | Đọc `anon_key`, `service_key`, `db_url`; bí mật, không log |
+| `cloud_base_delete` | Xoá Base đã được duyệt |
+
+Mỗi tool có alias `vibecloud_base_*` cùng schema và handler. Cần DB/Supabase cho app thì gọi `cloud_base_create`; Base dùng cùng account và khớp app deploy.
+
 `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

package/STATUS.md

@@ -1,4 +1,22 @@
-# STATUS — monacloud-mcp 0.4.0
+# STATUS — monacloud-mcp 0.5.0
+
+Updated: 2026-09-14 (Asia/Ho_Chi_Minh)
+
+## MONA Base beta — hoàn tất offline
+
+- Thêm `cloud_base_create`, `cloud_base_list`, `cloud_base_get`, `cloud_base_delete`, `cloud_base_credentials` và 5 alias `vibecloud_base_*` cùng schema/handler.
+- `cloud_base_create` dùng spend guard cho lượt thật, sandbox bỏ Billing và gửi `X-Vibecloud-Sandbox: 1`, poll job rồi chuẩn hoá `{base_id, studio_url, api_url, status}` cùng estimate sandbox.
+- Credential gửi `X-Confirm: reveal`, chỉ trả `anon_key`, `service_key`, `db_url` và nhắc “Bí mật, không log”. Lỗi giữ `{code,next_step}` cho agent.
+- Mô tả tool, instructions, resource, prompt, README và agent guide ghi Base **beta** = thay Supabase, chung account/ví MONA Cloud, khớp app deploy.
+- Package, binary và MCP handshake đã bump minor lên `0.5.0`; stdio có 145 tool.
+- `npm test` offline: **52 tests, 52 pass, 0 fail, 0 skip**, gồm TypeScript build và HTTP mock Base create/poll/sandbox/list/get/delete/credentials/aliases.
+- Không publish, không gọi API production. **Chờ Base provision-live để publish.**
+
+CODEX DONE
+
+---
+
+# Lịch sử — monacloud-mcp 0.4.0
 
 Updated: 2026-09-05 (Asia/Ho_Chi_Minh)
 

package/dist/base.d.ts

@@ -0,0 +1,3 @@
+import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import type { CloudClients } from './clients.js';
+export declare function registerBaseTools(server: McpServer, clients: CloudClients): void;

package/dist/base.js

@@ -0,0 +1,76 @@
+import { z } from 'zod';
+import { CloudError, runTool } from './errors.js';
+import { pollJob, TERMINAL_JOBS } from './jobs.js';
+import { unwrapData } from './http.js';
+const object = (value) => value && typeof value === 'object' ? value : {};
+const id = z.string().trim().min(1).max(255);
+const sandbox = z.boolean().optional().describe('Thử 0đ, chỉ ước tính và không tạo hạ tầng thật / Sandbox estimate only');
+const baseDescription = 'Base beta = thay Supabase, chung account/ví MONA Cloud. / Beta Supabase replacement on the shared MONA Cloud account and wallet.';
+function value(objects, key) {
+    for (const row of objects)
+        if (row[key] !== undefined)
+            return row[key];
+    return undefined;
+}
+async function createBase(clients, body) {
+    const { sandbox: requested, ...payload } = body;
+    const isSandbox = clients.sandboxEnabled(requested === true);
+    const created = object(unwrapData(await clients.guardedVibecloud('/api/bases', { method: 'POST', body: payload }, isSandbox)));
+    const jobId = typeof created.job_id === 'string' ? created.job_id
+        : typeof created.id === 'string' ? created.id : undefined;
+    const job = jobId && !TERMINAL_JOBS.has(String(created.status))
+        ? await pollJob(clients, jobId, true, 3, 180, isSandbox)
+        : created;
+    const result = object(job.result);
+    const base = object(result.base);
+    const rows = [base, result, job, created];
+    const status = String(value(rows, 'status') || 'unknown');
+    if (['failed', 'error', 'cancelled'].includes(status)) {
+        throw new CloudError('base_provision_failed', `Tạo Base thất bại${jobId ? ` (job ${jobId})` : ''}: ${job.error || result.error || 'không có chi tiết'}`, 'Kiểm tra cấu hình/giá và cloud_base_list; chỉ gọi lại cloud_base_create sau khi sửa nguyên nhân.');
+    }
+    return {
+        base_id: value(rows, 'base_id') ?? value(rows, 'id'),
+        studio_url: value(rows, 'studio_url'),
+        api_url: value(rows, 'api_url'),
+        status,
+        ...(jobId ? { job_id: jobId } : {}),
+        ...(result.estimate !== undefined ? { estimate: result.estimate } : created.estimate !== undefined ? { estimate: created.estimate } : {}),
+        ...(isSandbox ? {
+            sandbox: true,
+            next_step: 'Đây là ước tính beta, chưa tạo Base. Duyệt chi phí rồi gọi cloud_base_create với sandbox=false.',
+        } : {}),
+        ...(job.polling === 'timeout' ? { polling: 'timeout', next_step: job.next_step } : {}),
+    };
+}
+export function registerBaseTools(server, clients) {
+    const register = (name, description, schema, handler) => {
+        for (const toolName of [name, name.replace(/^cloud_/, 'vibecloud_')]) {
+            server.registerTool(toolName, {
+                description: toolName === name ? `${description} ${baseDescription}` : `Alias tương thích của ${name}. / Compatibility alias. ${description} ${baseDescription}`,
+                inputSchema: schema,
+            }, (args) => runTool(() => handler(args)));
+        }
+    };
+    register('cloud_base_create', 'Ước tính, kiểm ví, tạo Base và poll job tới hoàn tất; sandbox chỉ trả ước tính. / Estimate, create and wait for the Base job.', z.object({
+        cpu: z.number().int().min(1).max(16).optional(),
+        ram_gb: z.number().int().min(1).max(64).optional(),
+        disk_gb: z.number().int().min(10).max(1000).optional(),
+        billing_mode: z.enum(['hourly', 'monthly']).optional(),
+        plan_code: z.string().trim().min(2).max(64).optional(),
+        sandbox,
+    }).strict(), (args) => createBase(clients, args));
+    register('cloud_base_list', 'Liệt kê Base beta của tài khoản hiện tại. / List Bases.', z.object({}).strict(), () => clients.vibecloud('/api/bases'));
+    register('cloud_base_get', 'Đọc trạng thái và URL của một Base beta. / Inspect a Base.', z.object({ base_id: id }).strict(), ({ base_id }) => clients.vibecloud(`/api/bases/${encodeURIComponent(base_id)}`));
+    register('cloud_base_delete', 'Xoá Base beta đã được người dùng duyệt. / Delete an approved Base.', z.object({ base_id: id }).strict(), ({ base_id }) => clients.vibecloud(`/api/bases/${encodeURIComponent(base_id)}`, { method: 'DELETE' }));
+    register('cloud_base_credentials', 'Đọc anon_key, service_key và db_url. Bí mật, không log; lưu thẳng vào secret store hoặc .env không commit. / Reveal credentials once and keep them secret.', z.object({ base_id: id }).strict(), async ({ base_id }) => {
+        const raw = object(unwrapData(await clients.vibecloud(`/api/bases/${encodeURIComponent(base_id)}/credentials`, {
+            headers: { 'X-Confirm': 'reveal' },
+        })));
+        return {
+            anon_key: raw.anon_key,
+            service_key: raw.service_key,
+            db_url: raw.db_url,
+            warning: 'Bí mật, không log. Lưu vào secret store hoặc .env đã bỏ khỏi git.',
+        };
+    });
+}

package/dist/compute.d.ts

@@ -1,7 +1,7 @@
 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 = "AI l\u00E0m 99%: cloud_app_detect(local_dir) offline \u2192 cloud_app_host_list, cloud_prices/cloud_packages/cloud_plan_list v\u00E0 cloud_balance \u2192 cloud_app_create(local_dir, sandbox=true) n\u1EBFu ch\u01B0a c\u00F3 app host \u0111\u1EC3 \u01B0\u1EDBc t\u00EDnh chi ph\u00ED gi\u1EDD/g\u00F3i \u2192 h\u1ECFi human m\u1ED9t l\u1EA7n duy\u1EC7t chi ph\u00ED n\u1EBFu ch\u01B0a \u0111\u01B0\u1EE3c duy\u1EC7t \u2192 cloud_app_create(local_dir, sandbox=false) \u2192 poll t\u1EDBi done/succeeded \u2192 ki\u1EC3m v\u00E0 tr\u1EA3 URL. N\u1EBFu human c\u00F3 domain: cloud_app_domain_add v\u00E0 h\u01B0\u1EDBng d\u1EABn CNAME t\u1EEB API. Human \u0111\u0103ng k\u00FD MONA Pass b\u1EB1ng device flow, n\u1EA1p ti\u1EC1n khi h\u1EBFt credit 20k; AI l\u00E0m c\u00E1c b\u01B0\u1EDBc c\u00F2n l\u1EA1i. App git cloud_app_create(repo_url) \u0111\u00E3 live; kh\u00F4ng g\u1ECDi agent_deploy cho deploy d\u1EF1 \u00E1n. / Detect locally, estimate, obtain cost approval once, upload and deploy, return URL, then attach an optional domain.";
+export declare const APP_FLOW = "AI l\u00E0m 99%: cloud_app_detect(local_dir) offline \u2192 cloud_app_host_list, cloud_prices/cloud_packages/cloud_plan_list v\u00E0 cloud_balance \u2192 cloud_app_create(local_dir, sandbox=true) n\u1EBFu ch\u01B0a c\u00F3 app host \u0111\u1EC3 \u01B0\u1EDBc t\u00EDnh chi ph\u00ED gi\u1EDD/g\u00F3i \u2192 h\u1ECFi human m\u1ED9t l\u1EA7n duy\u1EC7t chi ph\u00ED n\u1EBFu ch\u01B0a \u0111\u01B0\u1EE3c duy\u1EC7t \u2192 cloud_app_create(local_dir, sandbox=false) \u2192 poll t\u1EDBi done/succeeded \u2192 ki\u1EC3m v\u00E0 tr\u1EA3 URL. C\u1EA7n DB/Supabase? cloud_base_create (beta) \u2014 chung account/v\u00ED MONA Cloud, kh\u1EDBp app deploy. N\u1EBFu human c\u00F3 domain: cloud_app_domain_add v\u00E0 h\u01B0\u1EDBng d\u1EABn CNAME t\u1EEB API. Human \u0111\u0103ng k\u00FD MONA Pass b\u1EB1ng device flow, n\u1EA1p ti\u1EC1n khi h\u1EBFt credit 20k; AI l\u00E0m c\u00E1c b\u01B0\u1EDBc c\u00F2n l\u1EA1i. App git cloud_app_create(repo_url) \u0111\u00E3 live; kh\u00F4ng g\u1ECDi agent_deploy cho deploy d\u1EF1 \u00E1n. / Detect locally, estimate, obtain cost approval once, upload and deploy, create an optional Base, return URL, then attach an optional domain.";
 export declare function rows(value: unknown, key: string): Row[];
 export declare function planEstimate(clients: CloudClients, code: string, cycle?: string): Promise<{
     plan: Row;

package/dist/compute.js

@@ -4,7 +4,7 @@ import { unwrapData } from './http.js';
 import { finishAppJob } from './jobs.js';
 import { detectProject } from './local.js';
 import { localAppTools } from './local-app.js';
-export const APP_FLOW = 'AI làm 99%: cloud_app_detect(local_dir) offline → cloud_app_host_list, cloud_prices/cloud_packages/cloud_plan_list và cloud_balance → cloud_app_create(local_dir, sandbox=true) nếu chưa có app host để ước tính chi phí giờ/gói → hỏi human một lần duyệt chi phí nếu chưa được duyệt → cloud_app_create(local_dir, sandbox=false) → poll tới done/succeeded → kiểm và trả URL. Nếu human có domain: cloud_app_domain_add và hướng dẫn CNAME từ API. Human đăng ký MONA Pass bằng device flow, nạp tiền khi hết credit 20k; AI làm các bước còn lại. App git cloud_app_create(repo_url) đã live; không gọi agent_deploy cho deploy dự án. / Detect locally, estimate, obtain cost approval once, upload and deploy, return URL, then attach an optional domain.';
+export const APP_FLOW = 'AI làm 99%: cloud_app_detect(local_dir) offline → cloud_app_host_list, cloud_prices/cloud_packages/cloud_plan_list và cloud_balance → cloud_app_create(local_dir, sandbox=true) nếu chưa có app host để ước tính chi phí giờ/gói → hỏi human một lần duyệt chi phí nếu chưa được duyệt → cloud_app_create(local_dir, sandbox=false) → poll tới done/succeeded → kiểm và trả URL. Cần DB/Supabase? cloud_base_create (beta) — chung account/ví MONA Cloud, khớp app deploy. Nếu human có domain: cloud_app_domain_add và hướng dẫn CNAME từ API. Human đăng ký MONA Pass bằng device flow, nạp tiền khi hết credit 20k; AI làm các bước còn lại. App git cloud_app_create(repo_url) đã live; không gọi agent_deploy cho deploy dự án. / Detect locally, estimate, obtain cost approval once, upload and deploy, create an optional Base, return URL, then attach an optional domain.';
 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);

package/dist/index.js

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

package/dist/server.js

@@ -10,7 +10,8 @@ import { TemplateCatalog } from './templates.js';
 import { registerMailTools } from './mail.js';
 import { APP_FLOW, createVps, registerComputeTools } from './compute.js';
 import { pollJob } from './jobs.js';
-const ENTITY = 'MONA Cloud là hệ công cụ cho vibecoder Việt Nam: một MONA Pass, một ví VND và một MCP để chạy app/VPS, thu tiền MONA Pay và dùng các sản phẩm MONA. Dùng mail_* để gửi email giao dịch (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.';
+import { registerBaseTools } from './base.js';
+const ENTITY = 'MONA Cloud là hệ công cụ cho vibecoder Việt Nam: một MONA Pass, một ví VND và một MCP để chạy app/VPS, thu tiền MONA Pay và dùng các sản phẩm MONA. Base beta thay Supabase bằng cloud_base_*, chung account/ví MONA Cloud và khớp app deploy. Dùng mail_* để gửi email giao dịch (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.';
 const SANDBOX_DESCRIPTION = 'sandbox=true: thử 0đ, không cần ví';
 const sandboxSchema = z.boolean().optional().describe(SANDBOX_DESCRIPTION);
 const asObject = (value) => (value && typeof value === 'object' ? value : {});
@@ -90,7 +91,7 @@ export function createServer(dependencies = {}) {
     const auth = new AuthManager(config, env, fetchImpl);
     const clients = new CloudClients(config, auth, fetchImpl);
     const catalog = new TemplateCatalog(config, fetchImpl);
-    const server = new McpServer({ name: 'monacloud-mcp', version: '0.4.0' }, { instructions: `${ENTITY}\nDùng cloud_* cho tài khoản, ví và hạ tầng; monapay_* cho thu tiền; mail_* để gửi email giao dịch (MONA Mail); agent_* cho catalog. Không bao giờ yêu cầu mật khẩu sản phẩm. Đọc → ước tính → hỏi duyệt nếu chưa được duyệt → làm. Dừng khi cần DNS, nạp tiền, duyệt chi phí, OTP hoặc KYC. ${APP_FLOW}` });
+    const server = new McpServer({ name: 'monacloud-mcp', version: '0.5.0' }, { instructions: `${ENTITY}\nDùng cloud_* cho tài khoản, ví và hạ tầng; monapay_* cho thu tiền; mail_* để gửi email giao dịch (MONA Mail); agent_* cho catalog. Không bao giờ yêu cầu mật khẩu sản phẩm. Đọc → ước tính → hỏi duyệt nếu chưa được duyệt → làm. Dừng khi cần DNS, nạp tiền, duyệt chi phí, OTP hoặc KYC. ${APP_FLOW}` });
     server.registerTool('cloud_whoami', {
         title: 'Tài khoản MONA Cloud',
         description: 'Xác minh MONA Pass hiện tại. / Return the current MONA Pass profile.',
@@ -304,6 +305,7 @@ export function createServer(dependencies = {}) {
         inputSchema: { template: z.string().regex(/^[a-z0-9][a-z0-9-]{0,79}$/), sandbox: sandboxSchema },
     }, ({ template, sandbox }) => runTool(() => agentRuntimeStub(template, clients.sandboxEnabled(sandbox))));
     registerComputeTools(server, clients);
+    registerBaseTools(server, clients);
     registerMailTools(server, clients, config);
     server.registerTool('agent_templates_list', {
         title: 'Catalog MONA Agent',
@@ -347,7 +349,7 @@ export function createServer(dependencies = {}) {
     }, async (uri) => ({ contents: [{
                 uri: uri.href,
                 mimeType: 'text/plain',
-                text: `${ENTITY}\n\n${APP_FLOW}\n\nHuman đăng ký MONA Pass, duyệt chi phí, thêm DNS khi cần, nạp tiền và cung cấp OTP/KYC bắt buộc. AI dùng MCP làm phần còn lại.\n\n- cloud_*: tài khoản, ví, ledger, usage, budget, VPS, database, job, vòng đời service, plans, subscriptions, invoices/PDF, credit và apps từ git hoặc thư mục local (source=upload); cloud_app_detect hoàn toàn offline.\n- monapay_*: nối ngân hàng, checkout/QR, giao dịch, webhook và email.\n- mail_*: tài khoản, domain, API key, gửi mail, trạng thái, webhook, suppression (MONA Mail https://monamail.vn, API https://api.monamail.vn)\n- agent_*: catalog và deploy template.\n\nMONA Cloud: https://monacloud.vn\nCompute API: https://api.monacloud.vn\nMONA Pay: https://monapay.vn\n`,
+                text: `${ENTITY}\n\n${APP_FLOW}\n\nHuman đăng ký MONA Pass, duyệt chi phí, thêm DNS khi cần, nạp tiền và cung cấp OTP/KYC bắt buộc. AI dùng MCP làm phần còn lại.\n\n- cloud_*: tài khoản, ví, ledger, usage, budget, VPS, database, Base beta thay Supabase, job, vòng đời service, plans, subscriptions, invoices/PDF, credit và apps từ git hoặc thư mục local (source=upload); cần DB/Supabase thì dùng cloud_base_create — chung account, khớp app deploy; cloud_app_detect hoàn toàn offline.\n- monapay_*: nối ngân hàng, checkout/QR, giao dịch, webhook và email.\n- mail_*: tài khoản, domain, API key, gửi mail, trạng thái, webhook, suppression (MONA Mail https://monamail.vn, API https://api.monamail.vn)\n- agent_*: catalog và deploy template.\n\nMONA Cloud: https://monacloud.vn\nCompute API: https://api.monacloud.vn\nMONA Pay: https://monapay.vn\n`,
             }] }));
     server.registerResource('monacloud-status', 'monacloud://status', {
         title: 'Trạng thái hệ MONA Cloud',
@@ -374,7 +376,7 @@ export function createServer(dependencies = {}) {
                 role: 'user',
                 content: {
                     type: 'text',
-                    text: `Dựng app bán hàng ${app_name || 'của tôi'} bằng ${framework || 'stack phù hợp'} trên MONA Cloud. ${APP_FLOW}\nTheo đúng thứ tự:\n1. Gọi cloud_whoami, cloud_balance, cloud_plan_list, cloud_packages và cloud_prices. Báo ước tính và hỏi duyệt chi phí nếu chưa được duyệt. Nếu thiếu tiền, gọi cloud_topup rồi dừng để người dùng quét VietQR.\n2. Nếu dùng VPS gọi cloud_vps_create và cloud_db_create; nếu deploy dự án dùng cloud_app_detect(local_dir), cloud_app_host_list rồi cloud_app_create(local_dir), sandbox trước nếu chưa có host. Poll từng job bằng cloud_job_status tới done/succeeded.\n3. Gọi monapay_link nếu MONA Pay còn ở lớp chuyển tiếp. Gọi monapay_whoami; nếu chưa có VA, nối ngân hàng bằng chuỗi monapay_link_bank_start → HỎI OTP → verify → notification_register → HỎI OTP lần 2 → verify. Không tự đoán OTP.\n4. Viết endpoint webhook có HMAC và idempotency theo transaction_code; đăng ký bằng monapay_create_webhook, bắn monapay_test_webhook và đọc monapay_webhook_logs.\n5. Tích hợp monapay_create_checkout hoặc monapay_create_qr vào app, chỉ giao hàng sau CHECKOUT_PAID.\n6. Với dự án local, dùng cloud_app_create(local_dir) sau khi duyệt ước tính; git dùng repo_url; kiểm cloud_app_get/cloud_app_logs và health rồi báo URL. Chỉ dùng VPS thủ công khi người dùng chọn. Không yêu cầu người dùng mở dashboard ngoài bước nạp tiền/OTP bắt buộc.`,
+                    text: `Dựng app bán hàng ${app_name || 'của tôi'} bằng ${framework || 'stack phù hợp'} trên MONA Cloud. ${APP_FLOW}\nTheo đúng thứ tự:\n1. Gọi cloud_whoami, cloud_balance, cloud_plan_list, cloud_packages và cloud_prices. Báo ước tính và hỏi duyệt chi phí nếu chưa được duyệt. Nếu thiếu tiền, gọi cloud_topup rồi dừng để người dùng quét VietQR.\n2. Nếu dùng VPS gọi cloud_vps_create và cloud_db_create. Cần DB/Supabase thì ưu tiên cloud_base_create (beta) — chung account, khớp app deploy. Nếu deploy dự án dùng cloud_app_detect(local_dir), cloud_app_host_list rồi cloud_app_create(local_dir), sandbox trước nếu chưa có host. Poll từng job bằng cloud_job_status tới done/succeeded.\n3. Gọi monapay_link nếu MONA Pay còn ở lớp chuyển tiếp. Gọi monapay_whoami; nếu chưa có VA, nối ngân hàng bằng chuỗi monapay_link_bank_start → HỎI OTP → verify → notification_register → HỎI OTP lần 2 → verify. Không tự đoán OTP.\n4. Viết endpoint webhook có HMAC và idempotency theo transaction_code; đăng ký bằng monapay_create_webhook, bắn monapay_test_webhook và đọc monapay_webhook_logs.\n5. Tích hợp monapay_create_checkout hoặc monapay_create_qr vào app, chỉ giao hàng sau CHECKOUT_PAID.\n6. Với dự án local, dùng cloud_app_create(local_dir) sau khi duyệt ước tính; git dùng repo_url; kiểm cloud_app_get/cloud_app_logs và health rồi báo URL. Chỉ dùng VPS thủ công khi người dùng chọn. Không yêu cầu người dùng mở dashboard ngoài bước nạp tiền/OTP bắt buộc.`,
                 },
             }] }));
     server.registerPrompt('gui-mail-otp-monamail', {

package/docs/ai-agent.md

@@ -2,7 +2,7 @@
 
 Tài liệu này dành cho Claude, Codex, Cursor và agent dùng Model Context Protocol. Mục tiêu là hoàn thành tích hợp end-to-end mà không yêu cầu người dùng mở dashboard; các bước human gồm đăng ký MONA Pass, duyệt chi phí, thêm DNS khi cần, nạp tiền và OTP/KYC bắt buộc.
 
-## Luồng chuẩn 0.4.0: AI làm 99%
+## Luồng chuẩn 0.5.0: AI làm 99%
 
 Prompt Claude Code: **“Đưa dự án này lên MONA Cloud, dùng thư mục hiện tại”**.
 
@@ -11,6 +11,7 @@ Prompt Claude Code: **“Đưa dự án này lên MONA Cloud, dùng thư mục h
 3. `cloud_app_create({local_dir, name?, env?, sandbox:false})` đóng ZIP và upload. Poll tới done/succeeded, kiểm HTTPS/health rồi trả `{url, app_id, build, seconds}`. Khi response có `sandbox:true`/`needs_cost_approval:true`, đó vẫn là preview; làm theo `next_step` trước khi gọi thật.
 4. Nếu human có domain, `cloud_app_domain_add({app_id, host})`, đưa đúng CNAME do API trả, chờ DNS và kiểm HTTPS. Không tự đoán target CNAME.
 5. Sửa code local: `cloud_app_deploy({app_id, local_dir})`. Chỉ đổi env: `cloud_app_env_set` với map đầy đủ rồi `cloud_app_deploy({app_id})`. Timeout giữ job_id/app_id để tiếp tục, không tạo app mới.
+6. Cần DB/Supabase thì gọi `cloud_base_create` (beta): sandbox để lấy ước tính, duyệt chi phí rồi tạo thật. Base dùng chung account/ví MONA Cloud và khớp app deploy. Lưu credential vào secret store hoặc `.env` không commit; không log `anon_key`, `service_key`, `db_url`.
 
 Human chỉ cần đăng ký MONA Pass/device flow, duyệt chi phí một lần và nạp tiền khi hết credit 20k; DNS là bước thêm khi dùng domain riêng. AI làm các bước kỹ thuật còn lại. `.env*` kể cả `.env.example` không vào ZIP; truyền secret cần thiết qua `env`, không công khai. Xem [hợp đồng local deploy](local-deploy.md). VPS/database thủ công dưới đây chỉ dùng khi dự án cần hoặc người dùng chọn.
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "monacloud-mcp",
-  "version": "0.4.2",
+  "version": "0.5.0",
   "description": "Unified MCP server for MONA Cloud, MONA Pay and MONA Agent.",
   "license": "MIT",
   "type": "module",