@nextxai/cli 0.3.5 → 0.3.8

package/CHANGELOG.md

@@ -1,5 +1,14 @@
 # Changelog
 
+## 0.3.8
+
+- A workspace without an AI plan can still ask how-to questions in chat and with `-p`, up to the free daily limit.
+
+## 0.3.7
+
+- `-p` on a terminal now renders the answer: headings, bold, lists and tables. Piped or redirected output stays the raw text.
+- `webhooks events` and `status` show only the modules and roles of your product.
+
 ## 0.3.5
 
 - Vietnamese help keeps technical terms in English (API key, session, scope, signature, secret, retry, exit code, permission mode, output format, sandbox), and argument placeholders are English everywhere (`/rename <name>`, `/attach <file>`, `/config [key value]`).

package/dist/ai/client.js

@@ -105,12 +105,21 @@ export function composeText(question, attachments, projectNotes) {
         parts.push(`\n\n--- ${tr(`Chỉ dẫn của dự án (${brand().bin.toUpperCase()}.md)`, `Project instructions (${brand().bin.toUpperCase()}.md)`)} ---\n${projectNotes}\n---`);
     return parts.join("");
 }
+/** A workspace without an AI plan still gets how-to answers: the server's guidance door, same as the web app. */
+export const modeForPlan = (planCode) => (planCode ? undefined : "guidance");
+let cachedMode;
+const askMode = () => {
+    // A failed plan lookup keeps the normal path: the server still decides what this workspace may do.
+    cachedMode ??= usage().then((u) => modeForPlan(u.planCode), () => undefined);
+    return cachedMode;
+};
 /**
  * Sends one question and streams the answer. If the connection drops, the same Idempotency-Key is resent,
  * so the server replays the stored answer instead of answering (and charging) twice.
  */
 export async function ask(input) {
     const key = randomUUID();
+    const mode = await askMode();
     const body = {
         sessionId: input.sessionId,
         text: input.text,
@@ -118,6 +127,7 @@ export async function ask(input) {
         fileKeys: input.attachments?.filter((a) => a.fileKey).map((a) => a.fileKey) ?? undefined,
         agentCode: input.agent,
         clientPlatform: "cli",
+        ...(mode ? { mode } : {}),
     };
     let lastErr;
     for (let attempt = 0; attempt < 3; attempt++) {

package/dist/commands/ai.js

@@ -14,6 +14,7 @@ import { ask, attach, attachmentKind, composeText, confirmAction, listConversati
 import { LocalChat } from "../ai/local.js";
 import { mcpToken } from "../auth/mcp-oauth.js";
 import { defaultModel, resolveModel } from "../ai/models.js";
+import { markdownStream } from "../repl/markdown.js";
 // ── NEXTX.md ───────────────────────────────────────────────────────────────────────────────────────
 const NOTES_MAX = 4096;
 export function notesFileName() {
@@ -214,6 +215,15 @@ export async function runRoot(o, words) {
     await withWorkspace(context().workspace, () => (model ? printLocal(o, model, question, piped) : printAsk(o, question, piped)));
 }
 /** -p with --model: same output contract as the platform assistant, answered by the user's model. */
+/** On a terminal the answer is rendered; when piped or redirected it stays the raw text scripts expect. */
+function answerWriter(fmt) {
+    const stdout = process.stdout;
+    if (fmt === "text" && stdout.isTTY) {
+        const md = markdownStream((t) => stdout.write(t));
+        return { push: (t) => md.push(t), end: () => md.end() };
+    }
+    return { push: (t) => void stdout.write(t), end: (full) => void (full && !full.endsWith("\n") && stdout.write("\n")) };
+}
 async function printLocal(o, model, question, piped) {
     const attachments = [];
     for (const f of (o.file ?? []).slice(0, 3)) {
@@ -225,6 +235,7 @@ async function printLocal(o, model, question, piped) {
         attachments.push({ path: "-", name: "stdin", kind: "text", text: piped.slice(0, 20_000) });
     const fmt = outputFormat();
     const chat = new LocalChat(model, hasTty(), context().mode === "read");
+    const answer = answerWriter(fmt);
     const outcome = await chat.ask({
         text: composeText(question, attachments, findProjectNotes()?.text),
         onChunk: (ch) => {
@@ -233,7 +244,7 @@ async function printLocal(o, model, question, piped) {
             if (fmt !== "text")
                 return;
             if (ch.type === "token")
-                process.stdout.write(ch.text ?? "");
+                answer.push(ch.text ?? "");
             else if (ch.type === "activity" && ch.activity && !o.quiet)
                 process.stderr.write(c.dim(`⏺ ${ch.activity.label}\n`));
         },
@@ -241,8 +252,7 @@ async function printLocal(o, model, question, piped) {
     if (fmt === "json")
         json({ model: model.label, text: outcome.text, notices: outcome.notices, tools: outcome.activities.map((a) => a.toolName), workspace: getProfile(context().profile)?.workspaceCode ?? null, env: context().env, ended: outcome.ended });
     else if (fmt === "text") {
-        if (outcome.text && !outcome.text.endsWith("\n"))
-            process.stdout.write("\n");
+        answer.end(outcome.text);
         for (const n of outcome.notices)
             process.stderr.write(`${c.yellow("⚠")} ${n.message}\n`);
     }
@@ -261,6 +271,7 @@ async function printAsk(o, question, piped) {
     const text = composeText(question, attachments, notes?.text);
     const stdout = process.stdout;
     const stderr = process.stderr;
+    const answer = answerWriter(fmt);
     const outcome = await ask({
         sessionId,
         text,
@@ -272,7 +283,7 @@ async function printAsk(o, question, piped) {
             if (fmt !== "text")
                 return;
             if (ch.type === "token")
-                stdout.write(ch.text ?? "");
+                answer.push(ch.text ?? "");
             else if (ch.type === "activity" && ch.activity?.kind === "tool" && !o.quiet)
                 stderr.write(c.dim(`⏺ ${ch.activity.label}\n`));
         },
@@ -314,8 +325,7 @@ async function printAsk(o, question, piped) {
         });
     }
     else if (fmt === "text") {
-        if (outcome.text && !outcome.text.endsWith("\n"))
-            stdout.write("\n");
+        answer.end(outcome.text);
         // Notices the answer already says in words are not repeated.
         for (const n of outcome.notices)
             if (n.message && !outcome.text.includes(n.message.slice(0, 24)))

package/dist/commands/auth.js

@@ -1,4 +1,4 @@
-import { brand } from "../core/brand.js";
+import { brand, visibleModule } from "../core/brand.js";
 import { context } from "../core/context.js";
 import { CliError, Exit } from "../core/errors.js";
 import { tr } from "../core/i18n.js";
@@ -125,7 +125,7 @@ export function registerAuth(program) {
         };
         emit(data, () => {
             info(`${c.bold(me.fullName ?? "")} ${c.dim(me.email ?? "")}`);
-            info(`  ${tr("Workspace", "Workspace")}   ${c.bold(me.workspace?.name ?? "")} ${c.dim(me.workspace?.code ?? "")} · ${(me.groups ?? []).join(", ")}`);
+            info(`  ${tr("Workspace", "Workspace")}   ${c.bold(me.workspace?.name ?? "")} ${c.dim(me.workspace?.code ?? "")} · ${(me.groups ?? []).filter(visibleModule).join(", ")}`);
             info(`  ${tr("Môi trường", "Environment")}  ${context().env === "prod" ? c.red("prod") : c.yellow("sandbox")} · ${context().endpoints.api}`);
             if (u)
                 info(`  ${tr("Gói AI", "AI plan")}      ${u.planName ?? "-"}${u.limit ? ` · ${tr("đã dùng", "used")} ${u.used}/${u.limit}, ${tr("mở lại", "resets")} ${u.resetsAt?.slice(0, 10)}` : ""}`);

package/dist/commands/webhooks.js

@@ -1,7 +1,7 @@
 import { createHmac, timingSafeEqual } from "node:crypto";
 import { readFileSync } from "node:fs";
 import { fetch } from "undici";
-import { brand } from "../core/brand.js";
+import { brand, visibleModule } from "../core/brand.js";
 import { context } from "../core/context.js";
 import { CliError, Exit } from "../core/errors.js";
 import { currentLang, tr } from "../core/i18n.js";
@@ -22,7 +22,11 @@ function sigScheme() {
     return "Signature-256";
 }
 export async function eventTypes() {
-    return get("/webhook/public/event-types", { anonymous: true });
+    return visibleEvents(await get("/webhook/public/event-types", { anonymous: true }));
+}
+/** The event catalogue is shared by every product; each one shows only its own modules. */
+export function visibleEvents(list) {
+    return list.filter((e) => visibleModule(e.service));
 }
 /** Some platforms send `eventTypes` per endpoint and no single module. */
 async function listEndpoints() {

package/dist/repl/markdown.js

@@ -55,3 +55,41 @@ export function markdown(src) {
     }
     return out.join("\n");
 }
+/**
+ * Renders a streamed answer as it arrives. Text is held until a blank line outside a code fence closes the block, so
+ * bold markers and tables split across tokens still render whole.
+ */
+export function markdownStream(write) {
+    let buf = "";
+    const flush = (block) => {
+        if (block.trim())
+            write(`${markdown(block)}\n\n`);
+    };
+    return {
+        push(text) {
+            buf += text.replace(/\r/g, "");
+            for (;;) {
+                let fence = false;
+                let at = -1;
+                let pos = 0;
+                for (const line of buf.split("\n").slice(0, -1)) {
+                    if (/^```/.test(line))
+                        fence = !fence;
+                    else if (!fence && line.trim() === "" && pos > 0) {
+                        at = pos;
+                        break;
+                    }
+                    pos += line.length + 1;
+                }
+                if (at < 0)
+                    return;
+                flush(buf.slice(0, at));
+                buf = buf.slice(at + 1);
+            }
+        },
+        end() {
+            flush(buf);
+            buf = "";
+        },
+    };
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nextxai/cli",
-  "version": "0.3.5",
+  "version": "0.3.8",
   "description": "NextX in your terminal: chat with NextX AI on your workspace data, call the API, manage keys and webhooks",
   "keywords": [
     "nextx",