@nextxai/cli 0.1.0 → 0.2.0

package/dist/commands/webhooks.js

@@ -9,21 +9,51 @@ import { c, emit, info, json, ok, table, warn } from "../core/output.js";
 import { get, post, del, requestRaw, errorFor } from "../core/http.js";
 import { confirm, hasTty } from "../core/prompt.js";
 const when = (iso) => (iso ? iso.slice(0, 19).replace("T", " ") : "");
+const farm = () => brand().platform === "nextfarm";
+/** Signature headers per platform: `X-Nextfarm-Signature` on NextFarm, `…-Signature-256` otherwise (both sha256=HMAC(ts.body)). */
+const sigHeader = () => (farm() ? "x-nextfarm-signature" : "x-nextx-signature-256");
+const tsHeader = () => (farm() ? "x-nextfarm-timestamp" : "x-nextx-timestamp");
 export async function eventTypes() {
-    return get("/webhook/public/event-types", { anonymous: true });
+    if (!farm())
+        return get("/webhook/public/event-types", { anonymous: true });
+    const r = await get("/webhook/public/event-types", { anonymous: true, verbatim: true });
+    return r.events.map((e) => ({
+        event: e.event, service: e.group, title: currentLang() === "en" ? e.title_en ?? e.title : e.title, description: e.description,
+        descriptionEn: e.description_en, planRequired: e.scope, payloadSchema: e.payload_schema, example: e.example,
+    }));
+}
+/** NextFarm endpoints carry `eventTypes` and no single module. */
+async function listEndpoints() {
+    const list = await get("/webhook/endpoints");
+    return farm() ? list.map((e) => ({ ...e, events: e.eventTypes ?? [], status: e.isActive ? "active" : "disabled" })) : list;
+}
+/** NextFarm keeps deliveries per endpoint only; the CLI merges them. */
+async function listDeliveries(o) {
+    if (!farm()) {
+        const path = o.endpoint ? `/webhook/endpoints/${(await findEndpoint(o.endpoint)).id}/deliveries` : "/webhook/deliveries";
+        const r = await get(path, { query: { status: o.status, pageSize: o.limit } });
+        return Array.isArray(r) ? r : r.items;
+    }
+    const eps = o.endpoint ? [await findEndpoint(o.endpoint)] : await listEndpoints();
+    const all = (await Promise.all(eps.map((e) => get(`/webhook/endpoints/${e.id}/deliveries`, { query: { limit: o.limit } })))).flat();
+    return all
+        .map((d) => ({ id: d.id, eventType: d.eventType, status: d.status === "delivered" ? "success" : d.status, responseStatus: d.lastStatusCode, durationMs: d.lastDurationMs, retryCount: d.attemptCount, maxRetries: 8, deliveredAt: d.deliveredAt, createdAt: d.createdAt }))
+        .filter((d) => !o.status || d.status === o.status)
+        .sort((a, b) => b.createdAt.localeCompare(a.createdAt))
+        .slice(0, o.limit);
 }
 /** Checks both the NextX header (sha256=HMAC(ts.body)) and Standard Webhooks (v1,base64 HMAC(id.ts.body)). */
 export function verifySignature(secret, body, headers, toleranceSec = 300) {
     const h = Object.fromEntries(Object.entries(headers).map(([k, v]) => [k.toLowerCase(), v]));
     const eq = (a, b) => a.length === b.length && timingSafeEqual(Buffer.from(a), Buffer.from(b));
-    const ts = h["x-nextx-timestamp"] ?? h["webhook-timestamp"];
+    const ts = h[tsHeader()] ?? h["webhook-timestamp"];
     if (ts && Math.abs(Date.now() / 1000 - Number(ts)) > toleranceSec)
         return { ok: false, reason: tr("dấu thời gian quá cũ", "timestamp too old") };
-    if (h["x-nextx-signature-256"] && ts) {
+    if (h[sigHeader()] && ts) {
         const expected = "sha256=" + createHmac("sha256", secret).update(`${ts}.${body}`).digest("hex");
-        const got = [h["x-nextx-signature-256"], h["x-nextx-signature-256-previous"]].filter(Boolean);
+        const got = [h[sigHeader()], h[`${sigHeader()}-previous`]].filter(Boolean);
         if (got.some((g) => eq(g, expected)))
-            return { ok: true, scheme: "Signature-256" };
+            return { ok: true, scheme: farm() ? "X-Nextfarm-Signature" : "Signature-256" };
     }
     if (h["webhook-signature"] && h["webhook-id"] && ts) {
         const key = secret.startsWith("whsec_") ? Buffer.from(secret.slice(6), "base64") : Buffer.from(secret);
@@ -34,7 +64,7 @@ export function verifySignature(secret, body, headers, toleranceSec = 300) {
     return { ok: false, reason: tr("chữ ký không khớp", "signature mismatch") };
 }
 async function findEndpoint(id) {
-    const e = (await get("/webhook/endpoints")).find((x) => x.id.startsWith(id) || x.url === id);
+    const e = (await listEndpoints()).find((x) => x.id.startsWith(id) || x.url === id);
     if (!e)
         throw new CliError(tr("Không thấy endpoint này.", "Endpoint not found."), Exit.notFound);
     return e;
@@ -46,7 +76,7 @@ export function registerWebhooks(program) {
         let list = await eventTypes();
         if (o.module)
             list = list.filter((e) => e.service.toLowerCase() === o.module.toLowerCase());
-        emit(list, () => info(table([tr("Sự kiện", "Event"), tr("Phân hệ", "Module"), tr("Mô tả", "Description"), tr("Gói", "Plan")], list.map((e) => [e.event, e.service, (currentLang() === "en" ? e.descriptionEn ?? e.title : e.title), e.planRequired ?? ""]))));
+        emit(list, () => info(table([tr("Sự kiện", "Event"), tr("Phân hệ", "Module"), tr("Mô tả", "Description"), farm() ? tr("Quyền", "Permission") : tr("Gói", "Plan")], list.map((e) => [e.event, e.service, (currentLang() === "en" ? e.descriptionEn ?? e.title : e.title), e.planRequired ?? ""]))));
     });
     wh.command("schema <event>").description(tr("schema và ví dụ payload", "payload schema and example"))
         .action(async (event) => {
@@ -63,7 +93,7 @@ export function registerWebhooks(program) {
     });
     const ep = wh.command("endpoints").description(tr("endpoint nhận webhook của workspace", "your webhook endpoints"));
     ep.command("list", { isDefault: true }).action(async () => {
-        const list = await get("/webhook/endpoints");
+        const list = await listEndpoints();
         emit(list, () => info(table(["ID", "URL", tr("Sự kiện", "Events"), tr("Trạng thái", "Status"), tr("Lỗi liên tiếp", "Failures")], list.map((e) => [e.id.slice(0, 8), e.url, e.events.length > 3 ? `${e.events.slice(0, 3).join(", ")} +${e.events.length - 3}` : e.events.join(", "), e.isActive ? c.green(e.status) : c.dim(e.status), e.consecutiveFailures || ""]))));
     });
     ep.command("create <url>")
@@ -71,6 +101,19 @@ export function registerWebhooks(program) {
         .option("--description <text>")
         .action(async (url, o) => {
         const events = o.events.split(",").map((s) => s.trim()).filter(Boolean);
+        if (farm()) {
+            const known = new Set((await eventTypes()).map((t) => t.event));
+            const unknown = events.filter((e) => !known.has(e));
+            if (unknown.length)
+                throw new CliError(tr(`Không có sự kiện: ${unknown.join(", ")}`, `Unknown events: ${unknown.join(", ")}`), Exit.usage, `${brand().bin} webhooks events`);
+            const r = await post("/webhook/endpoints", { url, description: o.description, eventTypes: events });
+            emit(r, () => {
+                ok(tr("Đã tạo endpoint.", "Endpoint created."));
+                if (r.secret)
+                    info(`  ${tr("Khoá ký", "Signing secret")}: ${c.bold(String(r.secret))} ${c.dim(tr("(chỉ hiện một lần)", "(shown once)"))}`);
+            });
+            return;
+        }
         const types = await eventTypes();
         const services = [...new Set(events.map((e) => types.find((t) => t.event === e)?.service).filter(Boolean))];
         if (services.length !== 1)
@@ -98,10 +141,18 @@ export function registerWebhooks(program) {
     wh.command("trigger <event>").description(tr("bắn một sự kiện mẫu tới endpoint", "send a sample event to an endpoint"))
         .option("--endpoint <id>", tr("endpoint đích (mặc định: endpoint đầu tiên nhận sự kiện này)", "target endpoint (default: first one subscribed)"))
         .action(async (event, o) => {
-        const list = await get("/webhook/endpoints");
+        const list = await listEndpoints();
         const target = o.endpoint ? await findEndpoint(o.endpoint) : list.find((e) => e.events.includes(event));
         if (!target)
             throw new CliError(tr("Chưa có endpoint nào nhận sự kiện này.", "No endpoint subscribes to this event."), Exit.notFound, tr(`Dùng \`${brand().bin} webhooks listen --events ${event}\` để nghe về máy.`, `Use \`${brand().bin} webhooks listen --events ${event}\` to receive it locally.`));
+        if (farm()) {
+            // NextFarm sends a signed `webhook.test` and answers with the receiver's status straight away.
+            const t = await post(`/webhook/endpoints/${target.id}/test`, {});
+            emit(t, () => (t.ok ? ok : warn)(tr(`Đã gửi webhook.test → ${target.url}`, `Sent webhook.test → ${target.url}`) + ` · ${t.statusCode ? `HTTP ${t.statusCode}` : t.error ?? ""} · ${t.durationMs}ms`));
+            if (!t.ok)
+                process.exitCode = Exit.general;
+            return;
+        }
         const r = await post(`/webhook/endpoints/${target.id}/test`, { eventType: event });
         emit(r, () => ok(tr(`Đã gửi ${event} → ${target.url}`, `Sent ${event} → ${target.url}`) + (r.responseStatus ? ` · HTTP ${r.responseStatus}` : "")));
     });
@@ -110,15 +161,13 @@ export function registerWebhooks(program) {
         .option("--endpoint <id>")
         .option("--limit <n>", "", "30")
         .action(async (o) => {
-        const path = o.endpoint ? `/webhook/endpoints/${(await findEndpoint(o.endpoint)).id}/deliveries` : "/webhook/deliveries";
-        const r = await get(path, { query: { status: o.status, pageSize: o.limit } });
-        const list = Array.isArray(r) ? r : r.items;
+        const list = await listDeliveries({ endpoint: o.endpoint, status: o.status, limit: Number(o.limit) });
         emit(list, () => info(table(["ID", tr("Sự kiện", "Event"), tr("Kết quả", "Result"), "HTTP", "ms", tr("Thử lại", "Retries"), tr("Lúc", "At")], list.map((d) => [
             d.id.slice(0, 8), d.eventType, d.status === "success" ? c.green(d.status) : d.status === "failed" ? c.red(d.status) : d.status, d.responseStatus ?? "", d.durationMs ?? "", `${d.retryCount}/${d.maxRetries}`, when(d.createdAt),
         ]))));
     });
     wh.command("retry <deliveryId>").description(tr("gửi lại một lượt giao", "retry a delivery")).action(async (id) => {
-        const full = id.length >= 32 ? id : (await get("/webhook/deliveries", { query: { pageSize: 100 } }).then((r) => (Array.isArray(r) ? r : r.items).find((d) => d.id.startsWith(id))?.id));
+        const full = id.length >= 32 ? id : (await listDeliveries({ limit: 100 })).find((d) => d.id.startsWith(id))?.id;
         if (!full)
             throw new CliError(tr("Không thấy lượt giao này.", "Delivery not found."), Exit.notFound);
         const r = await post(`/webhook/deliveries/${full}/retry`, {});
@@ -139,9 +188,9 @@ export function registerWebhooks(program) {
                 headers[h.slice(0, i).trim()] = h.slice(i + 1).trim();
         }
         if (o.signature)
-            headers["x-nextx-signature-256"] = o.signature;
+            headers[sigHeader()] = o.signature;
         if (o.timestamp)
-            headers["x-nextx-timestamp"] = o.timestamp;
+            headers[tsHeader()] = o.timestamp;
         const r = verifySignature(o.secret, body, headers);
         emit(r, () => (r.ok ? ok(tr(`Chữ ký hợp lệ (${r.scheme})`, `Valid signature (${r.scheme})`)) : warn(tr(`Không hợp lệ: ${r.reason}`, `Invalid: ${r.reason}`))));
         if (!r.ok)

package/dist/core/brand.js

@@ -3,6 +3,7 @@
 // <brand:nextx>
 const NEXTX = {
     id: "nextx",
+    platform: "nextx",
     bin: "nextx",
     name: "NextX",
     aiName: "NextX AI",
@@ -10,6 +11,9 @@ const NEXTX = {
     clientId: "nextx-cli",
     envPrefix: "NEXTX",
     mobileApp: "NextX",
+    example: { vi: "doanh thu hôm qua", en: "yesterday's revenue" },
+    apiExample: "GET /crm/contacts -f q=Minh",
+    ciSettings: { vi: "Thiết lập › Ứng dụng & API › CI", en: "Settings › Apps & API › CI" },
     modules: null,
     env: {
         prod: {

package/dist/core/case.js

@@ -0,0 +1,23 @@
+// NextFarm services speak two JSON key styles: snake_case (iam, gis, iot, harvest, ai, report, hrm, connect, sales, einvoice)
+// and camelCase (office, notification, operator, finance). The CLI works in camelCase like the NextFarm web app, so keys
+// are converted on the wire for snake services only. Converting a camel service breaks writes silently: `task_id` does not
+// bind to `TaskId`, the field takes its default and the server still answers 200.
+import { brand } from "./brand.js";
+const SNAKE_SERVICES = ["iam", "gis", "iot", "harvest", "ai", "report", "hrm", "connect", "sales", "einvoice", "webhook"];
+const SNAKE_URL = new RegExp(`/v\\d+/(${SNAKE_SERVICES.join("|")})(/|$|\\?)`);
+/** Snake services with camelCase routes: Excel import keyed by column titles, consent with [JsonPropertyName], billing forwarded to operator. */
+const EXEMPT = [/\/v\d+\/gis\/import(\/|$|\?)/, /\/v\d+\/iam\/automation-rules(\/|$|\?)/, /\/v\d+\/iam\/billing(\/|$|\?)/];
+export function snakeOnWire(url) {
+    return brand().platform === "nextfarm" && SNAKE_URL.test(url) && !EXEMPT.some((r) => r.test(url));
+}
+const toSnake = (k) => k.replace(/([a-z0-9])([A-Z])/g, "$1_$2").replace(/([A-Z])([A-Z][a-z])/g, "$1_$2").toLowerCase();
+const toCamel = (k) => k.replace(/_([a-z0-9])/g, (_, ch) => ch.toUpperCase());
+function convert(v, key) {
+    if (Array.isArray(v))
+        return v.map((x) => convert(x, key));
+    if (v && typeof v === "object" && Object.getPrototypeOf(v) === Object.prototype)
+        return Object.fromEntries(Object.entries(v).map(([k, x]) => [key(k), convert(x, key)]));
+    return v;
+}
+export const snakeKeys = (v) => convert(v, toSnake);
+export const camelKeys = (v) => convert(v, toCamel);

package/dist/core/errors.js

@@ -11,6 +11,10 @@ export const Exit = {
     notFound: 8,
     interrupted: 130,
 };
+/** The brand's server does not offer this sign-in method yet. */
+export function notYetError(what, instead) {
+    return new CliError(`${what} — ${instead}`, Exit.usage);
+}
 export class CliError extends Error {
     exitCode;
     hint;

package/dist/core/http.js

@@ -1,12 +1,13 @@
 // Every call to the platform goes through here: identity headers, retry on expired token, error → exit code.
 import { randomUUID } from "node:crypto";
 import { arch, platform } from "node:os";
-import { fetch, EnvHttpProxyAgent, setGlobalDispatcher } from "undici";
+import { fetch, FormData, EnvHttpProxyAgent, setGlobalDispatcher } from "undici";
 import { brand } from "./brand.js";
 import { context } from "./context.js";
 import { CliError, Exit } from "./errors.js";
 import { t, currentLang } from "./i18n.js";
 import { VERSION } from "./version.js";
+import { snakeOnWire, snakeKeys, camelKeys } from "./case.js";
 import { currentAuth, refreshSession } from "../auth/session.js";
 setGlobalDispatcher(new EnvHttpProxyAgent());
 export const userAgent = () => `${brand().bin}-cli/${VERSION} (${platform()}; ${arch()}; node ${process.versions.node})`;
@@ -46,10 +47,11 @@ async function send(method, url, opts, auth) {
     };
     let body;
     if (opts.body !== undefined) {
-        if (typeof opts.body === "string")
+        // Multipart: undici sets the boundary itself, so no Content-Type here.
+        if (opts.body instanceof FormData || typeof opts.body === "string")
             body = opts.body;
         else {
-            body = JSON.stringify(opts.body);
+            body = JSON.stringify(!opts.verbatim && snakeOnWire(url) ? snakeKeys(opts.body) : opts.body);
             headers["Content-Type"] ??= "application/json";
         }
     }
@@ -158,7 +160,8 @@ export async function request(method, path, opts = {}) {
     const requestId = res.headers.get("x-request-id") ?? undefined;
     if (opts.raw)
         return { status: res.status, data: res, headers: res.headers, requestId };
-    const data = await readBody(res);
+    const body = await readBody(res);
+    const data = !opts.verbatim && snakeOnWire(res.url || path) ? camelKeys(body) : body;
     if (!res.ok && !opts.allow?.includes(res.status))
         throw errorFor(res.status, data, res);
     return { status: res.status, data: data, headers: res.headers, requestId };

package/dist/mcp/client.js

@@ -12,16 +12,19 @@ const PROTOCOL = "2025-06-18";
 export class McpClient {
     interactive;
     apiKey;
+    url;
     sessionId;
     nextId = 1;
     token;
     ready = false;
-    constructor(interactive, apiKey) {
+    /** `url`: MCP endpoint other than the hosted OAuth server (NextFarm API keys go through the gateway's /api/v1/mcp). */
+    constructor(interactive, apiKey, url) {
         this.interactive = interactive;
         this.apiKey = apiKey;
+        this.url = url;
     }
     async rpc(method, params, notification = false) {
-        const url = context().endpoints.mcp;
+        const url = this.url ?? context().endpoints.mcp;
         this.token ??= this.apiKey ?? (await mcpToken({ interactive: this.interactive }));
         const id = notification ? undefined : this.nextId++;
         const headers = {

package/dist/program.js

@@ -8,6 +8,7 @@ import { tr } from "./core/i18n.js";
 import { registerAuth } from "./commands/auth.js";
 import { registerWorkspace } from "./commands/workspace.js";
 import { registerAi, runRoot } from "./commands/ai.js";
+import { registerModel } from "./commands/model.js";
 import { registerTools } from "./commands/tools.js";
 import { registerApi } from "./commands/api.js";
 import { registerKeys } from "./commands/keys.js";
@@ -16,6 +17,7 @@ import { registerDocs } from "./commands/docs.js";
 import { registerMcp } from "./commands/mcp.js";
 import { registerUtil } from "./commands/util.js";
 import { registerHelp } from "./commands/help.js";
+import { registerCi } from "./commands/ci.js";
 const collect = (v, prev = []) => [...prev, v];
 export function buildProgram() {
     const b = brand();
@@ -32,6 +34,7 @@ export function buildProgram() {
         .option("--sandbox", tr("dùng môi trường thử nghiệm", "use the sandbox environment"))
         .option("-w, --workspace <code>", tr("chạy lệnh này trên workspace khác", "run this command on another workspace"))
         .option("--agent <code>", tr("chọn Agent thay cho Trợ lý chung", "choose an Agent instead of the general assistant"))
+        .option("--model <provider/name>", tr("dùng model của bạn qua MCP: claude, gemini, gpt, grok, ollama/<tên>", "use your own model over MCP: claude, gemini, gpt, grok, ollama/<name>"))
         .addOption(new Option("--mode <mode>", tr("chế độ quyền", "permission mode")).choices(["read", "propose", "auto"]))
         .addOption(new Option("--output-format <format>", tr("định dạng đầu ra", "output format")).choices(["text", "json", "stream-json"]))
         .option("--json", tr("viết tắt của --output-format json", "shorthand for --output-format json"))
@@ -54,12 +57,14 @@ export function buildProgram() {
     registerAuth(program);
     registerWorkspace(program);
     registerAi(program);
+    registerModel(program);
     registerTools(program);
     registerApi(program);
     registerKeys(program);
     registerWebhooks(program);
     registerDocs(program);
     registerMcp(program);
+    registerCi(program);
     registerUtil(program);
     registerHelp(program);
     for (const sub of program.commands)

package/dist/repl/App.js

@@ -19,7 +19,10 @@ import { deleteSession } from "../auth/credentials.js";
 import { findProjectNotes, notesFileName, proposalCard, renderBlocks, runLines } from "../commands/ai.js";
 import { markdown } from "./markdown.js";
 import { Editor, Menu, Select, edit } from "./components.js";
-import { SLASH, SHORTCUTS, matchSlash } from "./slash.js";
+import { LocalChat } from "../ai/local.js";
+import { listModels, resolveModel } from "../ai/models.js";
+import { SHORTCUTS, SLASH, matchSlash, slashCommands } from "./slash.js";
+import * as nf from "../ai/nextfarm.js";
 const MODES = ["propose", "auto", "read"];
 const modeLabel = (m) => m === "propose" ? c.cyan(tr("⏵⏵ đề xuất", "⏵⏵ propose")) : m === "auto" ? c.yellow(tr("⏵⏵ tự ghi việc thường", "⏵⏵ auto-write normal")) : c.dim(tr("⏸ chỉ đọc", "⏸ read only"));
 let seq = 0;
@@ -90,6 +93,7 @@ export function App(props) {
     const [modal, setModal] = useState(null);
     const [mode, setMode] = useState(context().mode);
     const [agent, setAgent] = useState(context().agent);
+    const [local, setLocal] = useState(() => (props.model ? new LocalChat(props.model, true, context().mode === "read") : undefined));
     const [sessionId, setSessionId] = useState(props.sessionId);
     const [pending, setPending] = useState([]);
     const [usageText, setUsageText] = useState("");
@@ -124,7 +128,7 @@ export function App(props) {
         const line2 = ` ${c.dim(`${process.cwd().replace(process.env.HOME ?? "", "~")}${notes ? ` (${notesFileName()})` : ""} · CLI ${VERSION}`)}`;
         const strip = (s) => s.replace(/\u001b\[[0-9;]*m/g, "");
         const pad = (s) => s + " ".repeat(Math.max(0, inner + 1 - [...strip(s)].length));
-        const title = `─ ${b.aiName} `;
+        const title = local ? `─ ${b.name} · model: ${local.model.label} · ${tr("công cụ qua MCP", "tools over MCP")} ` : `─ ${b.aiName} `;
         say([
             c.cyan(`╭${title}${"─".repeat(Math.max(0, inner - title.length + 2))}╮`),
             `${c.cyan("│")}${pad(line1)} ${c.cyan("│")}`,
@@ -191,6 +195,8 @@ export function App(props) {
         say(proposalCard(p).join("\n"));
         if (mode === "read")
             return say(c.dim(tr("  Chế độ chỉ đọc: không ghi. Shift+Tab để đổi.", "  Read-only mode: nothing written. Shift+Tab to change.")));
+        if (risk === "device")
+            return say(c.dim(tr(`  Việc chạm thiết bị / tự động hoá chỉ xác nhận trong app ${b.mobileApp}: ${context().endpoints.app}`, `  Device and automation actions are confirmed in the ${b.mobileApp} app: ${context().endpoints.app}`)));
         if (risk === "finance")
             return say(c.dim(tr(`  Việc tài chính chỉ xác nhận trong app: ${context().endpoints.app}`, `  Finance actions are confirmed in the app: ${context().endpoints.app}`)));
         const yes = mode === "auto" && risk === "normal" ? true : await askConfirm(p);
@@ -245,26 +251,38 @@ export function App(props) {
         const ctl = new AbortController();
         abortRef.current = ctl;
         try {
+            const onChunk = (ch) => {
+                const l = liveRef.current;
+                if (ch.type === "token")
+                    l.text += ch.text ?? "";
+                else if (ch.type === "activity" && ch.activity)
+                    l.activities.push(ch.activity);
+                else if (ch.type === "agent" && ch.agent)
+                    l.agent = ch.agent;
+                l.reconnecting = undefined;
+            };
+            if (local) {
+                const skipped = atts.filter((a) => a.kind !== "text");
+                if (skipped.length)
+                    say(c.yellow(tr(`  ⚠ Model riêng chỉ đọc tệp chữ; bỏ qua ${skipped.map((a) => a.name).join(", ")}.`, `  ⚠ Your own model reads text files only; skipped ${skipped.map((a) => a.name).join(", ")}.`)));
+                const out = await local.ask({ text: composeText(clean, atts.filter((a) => a.kind === "text"), notes?.text), signal: ctl.signal, onChunk });
+                setLastOutcome(out);
+                say(renderAnswer(out));
+                return;
+            }
             const out = await ask({
                 sessionId,
                 text: composeText(clean, atts, notes?.text),
                 attachments: atts,
                 agent: thisAgent,
                 signal: ctl.signal,
-                onChunk: (ch) => {
-                    const l = liveRef.current;
-                    if (ch.type === "token")
-                        l.text += ch.text ?? "";
-                    else if (ch.type === "activity" && ch.activity)
-                        l.activities.push(ch.activity);
-                    else if (ch.type === "agent" && ch.agent)
-                        l.agent = ch.agent;
-                    l.reconnecting = undefined;
-                },
+                onChunk,
                 onRetry: (n) => liveRef.current && (liveRef.current.reconnecting = n),
             });
             setLastOutcome(out);
-            updateProfile(context().profile, { lastConversation: sessionId });
+            if (out.sessionId && out.sessionId !== sessionId)
+                setSessionId(out.sessionId);
+            updateProfile(context().profile, { lastConversation: out.sessionId || sessionId });
             say(renderAnswer(out));
             if (out.proposedAction)
                 await handleProposal(out.proposedAction);
@@ -315,16 +333,88 @@ export function App(props) {
         say(`${c.green("✓")} ${tr(`Đã ghi vào ${relative(process.cwd(), target) || notesFileName()} — gửi kèm mọi câu hỏi trong thư mục này.`, `Saved to ${relative(process.cwd(), target) || notesFileName()} — sent with every question in this folder.`)}`);
     }
     // ── slash commands ────────────────────────────────────────────────────────────────────────────
+    /** NextFarm versions of the slash commands whose server contract differs. True = handled. */
+    async function farmSlash(cmd, arg) {
+        switch (cmd) {
+            case "undo": {
+                const target = nf.undoTarget(arg || undefined);
+                const ok = await pick(tr(`Hoàn tác "${target.label}"?`, `Undo "${target.label}"?`), [{ label: tr("Không", "No"), value: "n" }, { label: tr("Hoàn tác", "Undo"), value: "y" }]);
+                if (ok === "y")
+                    say(`${c.green("✓")} ${await nf.undo(target)}`);
+                return true;
+            }
+            case "why": {
+                const id = arg || lastOutcome?.runId;
+                if (!id)
+                    throw new Error(tr("Chưa có câu trả lời nào trong phiên này.", "No answer in this session yet."));
+                say((await nf.runTrace(id)).join("\n"));
+                return true;
+            }
+            case "memory": {
+                const m = await nf.memories();
+                const [sub, id] = arg.split(/\s+/);
+                if (sub === "forget" && id) {
+                    const hit = m.items.find((x) => x.id.startsWith(id));
+                    if (!hit)
+                        throw new Error(tr("Không thấy điều nhớ này.", "Memory not found."));
+                    await nf.forgetMemory(hit.id);
+                    say(`${c.green("✓")} ${tr("Đã quên.", "Forgotten.")}`);
+                    return true;
+                }
+                say(m.items.length ? table(["ID", tr("Điều nhớ", "Memory"), tr("Dùng", "Uses")], m.items.map((x) => [x.id.slice(0, 8), x.display, x.uses])) + (m.canDelete ? c.dim("\n  /memory forget <id>") : "") : tr("  Trợ lý chưa nhớ gì về trang trại.", "  Nothing remembered about the farm yet."));
+                return true;
+            }
+            case "schedule": {
+                const m = /^"([^"]+)"\s+(daily|weekly)\s+(?:([1-7])@)?(\d{1,2}:\d{2})$/.exec(arg);
+                if (m) {
+                    const [, q, freq, day, time] = m;
+                    const s = await nf.createSchedule(q, freq, time.padStart(5, "0"), day ? Number(day) : undefined);
+                    say(`${c.green("✓")} ${tr(`Đã lên lịch · ${s.when}`, `Scheduled · ${s.when}`)}\n${c.dim(tr(`  Mở mục Trợ lý AI trong app ${b.mobileApp} một lần để cho phép chạy nền.`, `  Open the AI assistant in the ${b.mobileApp} app once to allow background runs.`))}`);
+                }
+                else {
+                    const list = await nf.schedules();
+                    say((list.length ? table(["ID", tr("Tên", "Title"), tr("Lịch", "When"), tr("Lần tới", "Next")], list.map((s) => [s.id.slice(0, 8), s.title, s.when, s.nextRunAt.slice(0, 16).replace("T", " ")])) + "\n" : "") + c.dim(tr('  /schedule "nhật ký hôm qua" daily 07:00 · weekly 1@07:00 (1 = thứ Hai)', '  /schedule "yesterday\'s log" daily 07:00 · weekly 1@07:00 (1 = Monday)')));
+                }
+                return true;
+            }
+            case "sau-benh": {
+                if (!arg)
+                    throw new Error(tr("Cần ảnh: /sau-benh <ảnh.jpg>", "Pass a photo: /sau-benh <photo.jpg>"));
+                const [path, ...note] = arg.split(/\s+/);
+                await addAttachment(path);
+                await send(note.length ? note.join(" ") : tr("Ảnh này cây bị sâu bệnh gì? Mức độ, cách xử lý và lô nào cần kiểm tra thêm.", "What pest or disease is in this photo? Severity, treatment and which plots to check."));
+                return true;
+            }
+            case "thoi-tiet":
+                await send(arg ? tr(`Thời tiết 3 ngày tới ở ${arg}, có ảnh hưởng gì tới việc phun, tưới, thu hoạch?`, `Weather for the next 3 days at ${arg} — any impact on spraying, irrigation, harvest?`)
+                    : tr("Thời tiết 3 ngày tới ở trang trại, có ảnh hưởng gì tới việc phun, tưới, thu hoạch?", "Weather for the next 3 days at the farm — any impact on spraying, irrigation, harvest?"));
+                return true;
+            case "ban-tin": {
+                const brief = await nf.latestBrief();
+                say(brief ? `${c.bold(brief.title)} ${c.dim(brief.createdAt.slice(0, 16).replace("T", " "))}\n${markdown(brief.text)}` : tr("  Chưa có bản tin sáng nào. Bật trong app: Trợ lý AI › Bản tin sáng.", "  No morning brief yet. Turn it on in the app: AI assistant › Morning brief."));
+                return true;
+            }
+            default:
+                return false;
+        }
+    }
     async function runSlash(line) {
         const [cmd0, ...rest] = line.slice(1).split(/\s+/);
         const cmd = (cmd0 ?? "").toLowerCase();
         const arg = rest.join(" ").trim();
         try {
+            // Commands that belong to another backend behave like unknown ones.
+            if (SLASH.some((s) => s.name === cmd) && !slashCommands().some((s) => s.name === cmd)) {
+                say(`${c.yellow("⚠")} ${tr(`Không có lệnh /${cmd}.`, `No command /${cmd}.`)} ${c.dim("/help")}`);
+                return;
+            }
+            if (b.platform === "nextfarm" && (await farmSlash(cmd, arg)))
+                return;
             switch (cmd) {
                 case "help":
                 case "?": {
-                    const w = Math.max(...SLASH.map((s) => s.name.length)) + 2;
-                    say([...SLASH.map((s) => `  ${c.cyan(`/${s.name}`.padEnd(w + 1))} ${s.description()}`), "", ...SHORTCUTS.map((s) => `  ${s.keys.padEnd(30)} ${c.dim(s.description())}`)].join("\n"));
+                    const w = Math.max(...slashCommands().map((s) => s.name.length)) + 2;
+                    say([...slashCommands().map((s) => `  ${c.cyan(`/${s.name}`.padEnd(w + 1))} ${s.description()}`), "", ...SHORTCUTS.map((s) => `  ${s.keys.padEnd(30)} ${c.dim(s.description())}`)].join("\n"));
                     break;
                 }
                 case "new": {
@@ -393,9 +483,22 @@ export function App(props) {
                     say(`  ${modeLabel(m)}`);
                     break;
                 }
-                case "model":
-                    say(c.dim(tr(`  Đang dùng ${b.aiName}. Model của bạn: chạy \`${b.bin} --model <tên>\` (xem \`${b.bin} model list\`).`, `  Using ${b.aiName}. Your own model: run \`${b.bin} --model <name>\` (see \`${b.bin} model list\`).`)));
+                case "model": {
+                    if (!arg) {
+                        const rows = listModels();
+                        say([
+                            `  ${tr("Đang dùng", "Using")} ${c.bold(local ? local.model.label : b.aiName)}`,
+                            `  ${c.cyan(b.bin.padEnd(10))} ${b.aiName}`,
+                            ...rows.map((r) => `  ${c.cyan(r.name.padEnd(10))} ${r.entry.model ?? ""}${r.hasKey ? "" : c.yellow(tr(" (chưa có khoá)", " (no key)"))}`),
+                            c.dim(`  /model ${b.bin} · /model claude · /model ollama/<model> · ${b.bin} model add <nhà>`),
+                        ].join("\n"));
+                        break;
+                    }
+                    const m = resolveModel(arg);
+                    setLocal(m ? new LocalChat(m, true, mode === "read") : undefined);
+                    say(`${c.green("✓")} ${m ? `${tr("Model của bạn", "Your model")}: ${m.label} · ${tr("công cụ qua MCP, ghi chỉ bằng link xác nhận, không trừ lượt AI", "tools over MCP, writes only via a confirmation link, no AI turns used")}` : b.aiName}`);
                     break;
+                }
                 case "attach":
                     if (!arg)
                         throw new Error(tr("Cần đường dẫn tệp.", "Pass a file path."));
@@ -765,7 +868,7 @@ export function App(props) {
     });
     // ── view ──────────────────────────────────────────────────────────────────────────────────────
     const p = profile();
-    const footerRight = c.dim(`${p?.workspaceName ?? ""} · ${context().env}${usageText ? ` · ${usageText}` : ""}${agent ? ` · ${agent}` : ""}`);
+    const footerRight = c.dim(`${p?.workspaceName ?? ""} · ${context().env}${local ? ` · ${local.model.label}` : usageText ? ` · ${usageText}` : ""}${agent && !local ? ` · ${agent}` : ""}`);
     const lastReason = live?.activities.filter((a) => a.kind !== "tool").at(-1);
     return (_jsxs(Box, { flexDirection: "column", children: [_jsx(Static, { items: done, children: (it) => _jsx(Text, { children: it.text }, it.id) }), live ? (_jsxs(Box, { flexDirection: "column", marginTop: 0, children: [live.agent && live.agent.code !== "general" ? _jsx(Text, { color: "cyan", children: `● ${live.agent.name}` }) : null, live.activities.filter((a) => a.kind === "tool").map((a, i) => (_jsx(Text, { color: "gray", children: `  ⏺ ${a.label}` }, i))), live.text ? _jsx(Text, { children: markdown(live.text).replace(/^/gm, "  ") }) : null, _jsxs(Text, { color: "gray", children: [_jsx(Spinner, { type: "dots" }), " ", live.reconnecting ? tr(`Mất kết nối, đang nối lại (${live.reconnecting}/2)…`, `Reconnecting (${live.reconnecting}/2)…`) : (lastReason?.label ?? tr("Đang nghĩ…", "Thinking…")), "  ", _jsx(Text, { dimColor: true, children: tr("Esc dừng", "Esc to stop") })] })] })) : null, modal?.kind === "select" ? (_jsx(Select, { title: modal.title, items: modal.items, initial: modal.initial, onPick: modal.resolve, hint: tr("↑↓ chọn · Enter · Esc huỷ", "↑↓ choose · Enter · Esc cancel") })) : modal?.kind === "confirm" ? (_jsx(Box, { marginTop: 0, children: riskOf(modal.proposal) === "large" ? (_jsxs(Text, { children: [c.yellow("└ "), tr(`Gõ ${c.bold(confirmWord(modal.proposal))} để xác nhận, Enter để huỷ`, `Type ${c.bold(confirmWord(modal.proposal))} to confirm, Enter to cancel`), " \u203A ", modal.typed, _jsx(Text, { inverse: true, children: " " })] })) : (_jsxs(Text, { children: [c.yellow("└ "), tr("Ghi?", "Write?"), " ", c.bold("[y]"), " ", tr("có", "yes"), "  ", c.bold("[n]"), " ", tr("không", "no"), "  ", c.bold("[d]"), " ", tr("xem dữ liệu", "show data")] })) })) : (_jsxs(Box, { flexDirection: "column", marginTop: 1, children: [pending.length ? _jsx(Text, { color: "gray", children: `  📎 ${pending.map((a) => a.name).join(", ")}` }) : null, _jsx(Editor, { value: value, cursor: cursor, disabled: busy, placeholder: busy ? "" : tr(`Hỏi ${b.aiName}… (/ để xem lệnh)`, `Ask ${b.aiName}… (/ for commands)`) }), menuItems.length ? _jsx(Menu, { items: menuItems, index: menuIndex }) : null, _jsxs(Box, { justifyContent: "space-between", width: width, children: [_jsx(Text, { children: `  ${modeLabel(mode)} ${c.dim("(Shift+Tab)")}` }), _jsx(Text, { children: footerRight })] })] }))] }));
 }

package/dist/repl/index.js

@@ -5,7 +5,7 @@ import { resolveConversation } from "../commands/ai.js";
 export async function startRepl(opts) {
     const sessionId = await resolveConversation(opts.flags);
     const resumed = Boolean(opts.flags.continue || opts.flags.resume);
-    const app = render(_jsx(App, { sessionId: sessionId, resumed: resumed, initialQuestion: opts.initialQuestion, files: (opts.flags.file ?? []).slice(0, 3) }), {
+    const app = render(_jsx(App, { sessionId: sessionId, resumed: resumed, initialQuestion: opts.initialQuestion, files: (opts.flags.file ?? []).slice(0, 3), model: opts.model }), {
         exitOnCtrlC: false,
     });
     await app.waitUntilExit();

package/dist/repl/slash.js

@@ -9,22 +9,25 @@ export const SLASH = [
     { name: "rename", args: "<tên>", description: () => tr("Đặt tên hội thoại này", "Rename this conversation") },
     { name: "pin", description: () => tr("Ghim / bỏ ghim hội thoại", "Pin / unpin this conversation") },
     { name: "workspace", args: "[mã]", description: () => tr("Đổi workspace đang làm việc", "Switch workspace") },
-    { name: "agent", args: "[mã]", description: () => tr("Chọn Agent: Trợ lý chung, Bán hàng, CSKH…", "Choose an Agent: general, sales, support…") },
+    { name: "agent", args: "[mã]", description: () => tr("Chọn Agent: Trợ lý chung, Bán hàng, CSKH…", "Choose an Agent: general, sales, support…"), platforms: ["nextx"] },
     { name: "mode", args: "read|propose|auto", description: () => tr("Chế độ quyền: chỉ đọc · đề xuất · tự ghi việc thường", "Permission mode: read · propose · auto") },
     { name: "model", args: "[tên]", description: () => tr(`Đổi model: ${brand().aiName} hoặc model của bạn`, `Switch model: ${brand().aiName} or your own`) },
     { name: "attach", args: "<tệp>", description: () => tr("Đính kèm tệp Excel / CSV / ảnh / tệp chữ", "Attach an Excel / CSV / image / text file") },
-    { name: "pending", description: () => tr("Đề xuất ghi đang chờ xác nhận", "Writes waiting for confirmation") },
+    { name: "pending", description: () => tr("Đề xuất ghi đang chờ xác nhận", "Writes waiting for confirmation"), platforms: ["nextx"] },
     { name: "undo", args: "[id]", description: () => tr("Hoàn tác lần ghi gần nhất", "Undo the last write") },
-    { name: "journal", description: () => tr("Nhật ký những gì AI đã ghi", "Journal of what the AI wrote") },
+    { name: "journal", description: () => tr("Nhật ký những gì AI đã ghi", "Journal of what the AI wrote"), platforms: ["nextx"] },
     { name: "why", args: "[runId]", description: () => tr("Vì sao AI trả lời vậy (các bước, công cụ đã gọi)", "Why the AI answered that way (steps, tools)") },
     { name: "memory", description: () => tr("AI đang nhớ gì về công ty — sửa, khoá, quên", "What the AI remembers — edit, lock, forget") },
     { name: "schedule", args: '"câu" daily 08:00', description: () => tr("Lên lịch một câu hỏi chạy hằng ngày / tuần / tháng", "Schedule a question daily / weekly / monthly") },
-    { name: "library", description: () => tr("Ảnh, tài liệu, tệp AI đã tạo", "Images, documents and files the AI produced") },
+    { name: "library", description: () => tr("Ảnh, tài liệu, tệp AI đã tạo", "Images, documents and files the AI produced"), platforms: ["nextx"] },
+    { name: "sau-benh", args: "<ảnh>", platforms: ["nextfarm"], description: () => tr("Chẩn đoán sâu bệnh từ ảnh lá, quả, thân", "Diagnose pests and diseases from a photo") },
+    { name: "thoi-tiet", args: "[lô]", platforms: ["nextfarm"], description: () => tr("Thời tiết mấy ngày tới ở trang trại / lô", "Weather for the farm or a plot in the coming days") },
+    { name: "ban-tin", platforms: ["nextfarm"], description: () => tr("Bản tin sáng mới nhất của trang trại", "The farm's latest morning brief") },
     { name: "export", args: "md|json [tệp]", description: () => tr("Xuất hội thoại ra Markdown / JSON", "Export the conversation to Markdown / JSON") },
     { name: "tools", description: () => tr("Công cụ AI bạn đang được dùng (theo quyền thật)", "AI tools you can use (by your real permissions)") },
-    { name: "usage", description: () => tr("Lượt AI tháng này", "AI turns this month") },
+    { name: "usage", description: () => brand().platform === "nextfarm" ? tr("Câu hỏi AI còn lại tuần này", "AI questions left this week") : tr("Lượt AI tháng này", "AI turns this month") },
     { name: "feedback", args: "up|down", description: () => tr("Báo câu trả lời vừa rồi tốt / chưa tốt", "Rate the last answer") },
-    { name: "support", args: "<vấn đề>", description: () => tr("Chuyển cho nhân viên hỗ trợ (mở ticket)", "Hand over to a support agent (ticket)") },
+    { name: "support", args: "<vấn đề>", description: () => tr("Chuyển cho nhân viên hỗ trợ (mở ticket)", "Hand over to a support agent (ticket)"), platforms: ["nextx"] },
     { name: "status", description: () => tr("Tài khoản, workspace, môi trường, phiên bản", "Account, workspace, environment, version") },
     { name: "doctor", description: () => tr("Kiểm kết nối, đồng hồ, token, gói", "Check connectivity, clock, token, plan") },
     { name: "config", args: "[khoá giá_trị]", description: () => tr("Cài đặt: ngôn ngữ, màu, thông báo cập nhật", "Settings: language, color, update notices") },
@@ -47,7 +50,11 @@ export const SHORTCUTS = [
     { keys: "Ctrl+L", description: () => tr("Xoá màn", "Clear screen") },
     { keys: "Ctrl+C · Ctrl+D", description: () => tr("Huỷ dòng đang gõ (2 lần để thoát) · thoát", "Clear input (twice to exit) · exit") },
 ];
+/** Commands of the current brand's backend — menu, `/help` and `help --json` all read this. */
+export function slashCommands() {
+    return SLASH.filter((s) => !s.platforms || s.platforms.includes(brand().platform));
+}
 export function matchSlash(prefix) {
     const p = prefix.replace(/^\//, "").toLowerCase();
-    return SLASH.filter((s) => s.name.startsWith(p));
+    return slashCommands().filter((s) => s.name.startsWith(p));
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nextxai/cli",
-  "version": "0.1.0",
+  "version": "0.2.0",
   "description": "NextX in your terminal: chat with NextX AI on your workspace data, call the API, manage keys and webhooks",
   "keywords": [
     "nextx",
@@ -41,6 +41,7 @@
     "test": "tsx --test test/*.test.ts"
   },
   "dependencies": {
+    "@anthropic-ai/sdk": "0.134.0",
     "commander": "14.0.3",
     "ink": "6.3.1",
     "ink-spinner": "5.0.0",