@xagent/x-cli 1.1.49 → 1.1.51

package/README.md

@@ -1,4 +1,4 @@
-## 1.1.49 – Logo Assets & NPM Publication Complete
+## 1.1.51 – Logo Assets & NPM Publication Complete
 
 ✅ **Live on NPM**: [@xagent/x-cli](https://www.npmjs.com/package/@xagent/x-cli) - Fully published and ready for global installation
 
@@ -155,6 +155,20 @@ A conversational AI CLI tool powered by Grok with **Claude Code-level intelligen
 
 ### 🚀 Quick Start
 
+#### 💎 **Try it now (no installation required!)**
+
+<div align="center">
+
+┌────────────────────────────────────┐
+│ 🚀 One-Command Start │
+├────────────────────────────────────┤
+│ npx -y @xagent/x-cli@latest │
+├────────────────────────────────────┤
+│ Always latest version • Zero setup │
+└────────────────────────────────────┘
+
+</div>
+
 **Option 1: Run without installing (Recommended)**
 
 ```bash

package/dist/index.js

@@ -5,7 +5,7 @@ import * as path7 from 'path';
 import path7__default from 'path';
 import * as os from 'os';
 import os__default from 'os';
-import React2, { useState, useRef, useEffect, useMemo, useCallback } from 'react';
+import React3, { useState, useRef, useEffect, useMemo, useCallback } from 'react';
 import { Box, Text, render, useApp, useInput } from 'ink';
 import { program, Command } from 'commander';
 import * as dotenv from 'dotenv';
@@ -58,7 +58,9 @@ var init_settings_manager = __esm({
         "grok-3-latest",
         "grok-3-fast",
         "grok-3-mini-fast"
-      ]
+      ],
+      verbosityLevel: "quiet",
+      explainLevel: "brief"
     };
     DEFAULT_PROJECT_SETTINGS = {
       model: "grok-code-fast-1"
@@ -9291,7 +9293,7 @@ EOF`;
 var package_default = {
   type: "module",
   name: "@xagent/x-cli",
-  version: "1.1.49",
+  version: "1.1.51",
   description: "An open-source AI agent that brings the power of Grok directly into your terminal.",
   main: "dist/index.js",
   module: "dist/index.js",
@@ -14883,6 +14885,22 @@ function useInputHandler({
   });
   const [shiftTabPressCount, setShiftTabPressCount] = useState(0);
   const [lastShiftTabTime, setLastShiftTabTime] = useState(0);
+  const [verbosityLevel, setVerbosityLevel] = useState(() => {
+    try {
+      const manager = getSettingsManager();
+      return manager.getUserSetting("verbosityLevel") || "quiet";
+    } catch {
+      return "quiet";
+    }
+  });
+  const [explainLevel, setExplainLevel] = useState(() => {
+    try {
+      const manager = getSettingsManager();
+      return manager.getUserSetting("explainLevel") || "brief";
+    } catch {
+      return "brief";
+    }
+  });
   const planMode = usePlanMode({}, agent);
   const handleSpecialKey = (key) => {
     if (isConfirmationActive) {
@@ -15129,6 +15147,8 @@ Built-in Commands:
   /clear      - Clear chat history
   /help       - Show this help
   /models     - Switch between available models
+  /verbosity  - Control output verbosity (quiet/normal/verbose)
+  /explain    - Control operation explanations (off/brief/detailed)
   /version    - Show version information and check for updates
   /upgrade    - Check for updates and upgrade automatically
   /switch     - Switch to specific version (/switch <version>)
@@ -16229,6 +16249,102 @@ Auto-compact automatically enables compact mode when conversations exceed thresh
       clearInput();
       return true;
     }
+    if (trimmedInput === "/verbosity" || trimmedInput.startsWith("/verbosity ")) {
+      const args = trimmedInput.split(" ").slice(1);
+      const newLevel = args[0];
+      if (!newLevel) {
+        const levelEntry = {
+          type: "assistant",
+          content: `\u{1F50A} **Current Verbosity Level: ${verbosityLevel.toUpperCase()}**
+
+**Available levels:**
+- \`quiet\` - Minimal output, suppress prefixes and extra formatting
+- \`normal\` - Current default behavior with full details
+- \`verbose\` - Additional details and debug information
+
+**Usage:** \`/verbosity <level>\`
+**Example:** \`/verbosity quiet\``,
+          timestamp: /* @__PURE__ */ new Date()
+        };
+        setChatHistory((prev) => [...prev, levelEntry]);
+      } else if (["quiet", "normal", "verbose"].includes(newLevel)) {
+        setVerbosityLevel(newLevel);
+        try {
+          const manager = getSettingsManager();
+          manager.updateUserSetting("verbosityLevel", newLevel);
+        } catch (_error) {
+        }
+        const confirmEntry = {
+          type: "assistant",
+          content: `\u2705 **Verbosity level set to: ${newLevel.toUpperCase()}**
+
+Tool outputs will now show ${newLevel === "quiet" ? "minimal output" : newLevel === "normal" ? "full details" : "extra details and debug information"}.`,
+          timestamp: /* @__PURE__ */ new Date()
+        };
+        setChatHistory((prev) => [...prev, confirmEntry]);
+      } else {
+        const errorEntry = {
+          type: "assistant",
+          content: `\u274C **Invalid verbosity level: ${newLevel}**
+
+**Available levels:** quiet, normal, verbose
+
+**Usage:** \`/verbosity <level>\``,
+          timestamp: /* @__PURE__ */ new Date()
+        };
+        setChatHistory((prev) => [...prev, errorEntry]);
+      }
+      clearInput();
+      return true;
+    }
+    if (trimmedInput === "/explain" || trimmedInput.startsWith("/explain ")) {
+      const args = trimmedInput.split(" ").slice(1);
+      const newLevel = args[0];
+      if (!newLevel) {
+        const levelEntry = {
+          type: "assistant",
+          content: `\u{1F4A1} **Current Explain Level: ${explainLevel.toUpperCase()}**
+
+**Available levels:**
+- \`off\` - No explanations
+- \`brief\` - Short reasons for operations
+- \`detailed\` - Comprehensive explanations with context
+
+**Usage:** \`/explain <level>\`
+**Example:** \`/explain brief\``,
+          timestamp: /* @__PURE__ */ new Date()
+        };
+        setChatHistory((prev) => [...prev, levelEntry]);
+      } else if (["off", "brief", "detailed"].includes(newLevel)) {
+        setExplainLevel(newLevel);
+        try {
+          const manager = getSettingsManager();
+          manager.updateUserSetting("explainLevel", newLevel);
+        } catch (_error) {
+        }
+        const confirmEntry = {
+          type: "assistant",
+          content: `\u2705 **Explain level set to: ${newLevel.toUpperCase()}**
+
+Operations will now ${newLevel === "off" ? "show no explanations" : newLevel === "brief" ? "show brief reasons" : "show detailed explanations with context"}.`,
+          timestamp: /* @__PURE__ */ new Date()
+        };
+        setChatHistory((prev) => [...prev, confirmEntry]);
+      } else {
+        const errorEntry = {
+          type: "assistant",
+          content: `\u274C **Invalid explain level: ${newLevel}**
+
+**Available levels:** off, brief, detailed
+
+**Usage:** \`/explain <level>\``,
+          timestamp: /* @__PURE__ */ new Date()
+        };
+        setChatHistory((prev) => [...prev, errorEntry]);
+      }
+      clearInput();
+      return true;
+    }
     const directBashCommands = [
       "ls",
       "pwd",
@@ -16430,6 +16546,8 @@ Auto-compact automatically enables compact mode when conversations exceed thresh
     availableModels,
     agent,
     autoEditEnabled,
+    verbosityLevel,
+    explainLevel,
     // Plan mode state and actions
     planMode
   };
@@ -16520,11 +16638,27 @@ function LoadingSpinner({
   message,
   progress
 }) {
-  if (!isActive) return null;
+  const [frameIndex, setFrameIndex] = useState(0);
+  const [messageIndex, setMessageIndex] = useState(0);
   const config2 = operationConfig[operation];
-  const spinnerChar = config2.spinner[0];
-  const operationMessage = message || config2.messages[0];
+  const spinnerChar = config2.spinner[frameIndex % config2.spinner.length];
+  const operationMessage = message || config2.messages[messageIndex % config2.messages.length];
   const color = getSpinnerColor(operation);
+  useEffect(() => {
+    if (!isActive) return;
+    const interval = setInterval(() => {
+      setFrameIndex((prev) => prev + 1);
+    }, 80);
+    return () => clearInterval(interval);
+  }, [isActive]);
+  useEffect(() => {
+    if (!isActive) return;
+    const messageInterval = setInterval(() => {
+      setMessageIndex((prev) => prev + 1);
+    }, 80 * config2.spinner.length * 3);
+    return () => clearInterval(messageInterval);
+  }, [isActive, config2.spinner.length]);
+  if (!isActive) return null;
   const renderProgressBar = () => {
     if (progress === void 0) return null;
     const barLength = 20;
@@ -16804,8 +16938,36 @@ var handleLongContent = (content, maxLength = 5e3) => {
     isTruncated: true
   };
 };
-var MemoizedChatEntry = React2.memo(
-  ({ entry, index }) => {
+var MemoizedChatEntry = React3.memo(
+  ({ entry, index, verbosityLevel, explainLevel }) => {
+    const getExplanation = (toolName, filePath, _isExecuting) => {
+      if (explainLevel === "off") return null;
+      const explanations = {
+        view_file: {
+          brief: `Reading ${filePath} to examine its contents`,
+          detailed: `Reading the file ${filePath} to examine its current contents, structure, and implementation details for analysis or modification.`
+        },
+        str_replace_editor: {
+          brief: `Updating ${filePath} with changes`,
+          detailed: `Applying targeted modifications to ${filePath} using precise string replacement to update specific code sections while preserving the rest of the file structure.`
+        },
+        create_file: {
+          brief: `Creating new file ${filePath}`,
+          detailed: `Creating a new file at ${filePath} with the specified content, establishing the initial structure and implementation for this component or module.`
+        },
+        bash: {
+          brief: `Executing command: ${filePath}`,
+          detailed: `Running the shell command "${filePath}" to perform system operations, file management, or external tool execution as requested.`
+        },
+        search: {
+          brief: `Searching for: ${filePath}`,
+          detailed: `Performing a comprehensive search across the codebase for "${filePath}" to locate relevant files, functions, or code patterns that match the query.`
+        }
+      };
+      const explanation = explanations[toolName];
+      if (!explanation) return null;
+      return explainLevel === "detailed" ? explanation.detailed : explanation.brief;
+    };
     const renderDiff = (diffContent, filename) => {
       return /* @__PURE__ */ jsx(
         DiffRenderer,
@@ -16924,6 +17086,9 @@ var MemoizedChatEntry = React2.memo(
         };
         const shouldShowDiff = entry.toolCall?.function?.name === "str_replace_editor" && entry.toolResult?.success && entry.content.includes("Updated") && entry.content.includes("---") && entry.content.includes("+++");
         const shouldShowFileContent = (entry.toolCall?.function?.name === "view_file" || entry.toolCall?.function?.name === "create_file") && entry.toolResult?.success && !shouldShowDiff;
+        const shouldShowToolContent = verbosityLevel !== "quiet";
+        const shouldShowFullContent = verbosityLevel === "normal" || verbosityLevel === "verbose";
+        const explanation = getExplanation(toolName, filePath);
         return /* @__PURE__ */ jsxs(Box, { flexDirection: "column", marginTop: 1, children: [
           /* @__PURE__ */ jsxs(Box, { children: [
             /* @__PURE__ */ jsx(Text, { color: "magenta", children: "\u23FA" }),
@@ -16932,20 +17097,24 @@ var MemoizedChatEntry = React2.memo(
               filePath ? `${actionName}(${filePath})` : actionName
             ] })
           ] }),
-          /* @__PURE__ */ jsx(Box, { marginLeft: 2, flexDirection: "column", children: isExecuting ? /* @__PURE__ */ jsx(Text, { color: "cyan", children: "\u23BF Executing..." }) : shouldShowFileContent ? /* @__PURE__ */ jsxs(Box, { flexDirection: "column", children: [
+          explanation && /* @__PURE__ */ jsx(Box, { marginLeft: 2, children: /* @__PURE__ */ jsxs(Text, { color: "blue", italic: true, children: [
+            "\u{1F4A1} ",
+            explanation
+          ] }) }),
+          shouldShowToolContent && /* @__PURE__ */ jsx(Box, { marginLeft: 2, flexDirection: "column", children: isExecuting ? /* @__PURE__ */ jsx(Text, { color: "cyan", children: "\u23BF Executing..." }) : shouldShowFileContent && shouldShowFullContent ? /* @__PURE__ */ jsxs(Box, { flexDirection: "column", children: [
             /* @__PURE__ */ jsx(Text, { color: "gray", children: "\u23BF File contents:" }),
             /* @__PURE__ */ jsx(Box, { marginLeft: 2, flexDirection: "column", children: renderFileContent(entry.content) })
-          ] }) : shouldShowDiff ? (
+          ] }) : shouldShowDiff && shouldShowFullContent ? (
             // For diff results, show only the summary line, not the raw content
             /* @__PURE__ */ jsxs(Text, { color: "gray", children: [
               "\u23BF ",
               entry.content.split("\n")[0]
             ] })
-          ) : /* @__PURE__ */ jsxs(Text, { color: "gray", children: [
+          ) : !shouldShowFullContent ? /* @__PURE__ */ jsx(Text, { color: "gray", children: "\u23BF Completed" }) : /* @__PURE__ */ jsxs(Text, { color: "gray", children: [
             "\u23BF ",
             formatToolContent(entry.content, toolName)
           ] }) }),
-          shouldShowDiff && !isExecuting && /* @__PURE__ */ jsx(Box, { marginLeft: 4, flexDirection: "column", children: renderDiff(entry.content, filePath) })
+          shouldShowDiff && !isExecuting && shouldShowFullContent && /* @__PURE__ */ jsx(Box, { marginLeft: 4, flexDirection: "column", children: renderDiff(entry.content, filePath) })
         ] }, index);
       default:
         return null;
@@ -16955,7 +17124,9 @@ var MemoizedChatEntry = React2.memo(
 MemoizedChatEntry.displayName = "MemoizedChatEntry";
 function ChatHistory({
   entries,
-  isConfirmationActive = false
+  isConfirmationActive = false,
+  verbosityLevel = "quiet",
+  explainLevel = "brief"
 }) {
   const filteredEntries = isConfirmationActive ? entries.filter(
     (entry) => !(entry.type === "tool_call" && entry.content === "Executing...")
@@ -16965,7 +17136,9 @@ function ChatHistory({
     MemoizedChatEntry,
     {
       entry,
-      index
+      index,
+      verbosityLevel,
+      explainLevel
     },
     `${entry.timestamp.getTime()}-${index}`
   )) });
@@ -18100,6 +18273,8 @@ function ChatInterfaceWithAgent({
     commandSuggestions,
     availableModels,
     autoEditEnabled,
+    verbosityLevel,
+    explainLevel,
     planMode
   } = useInputHandler({
     agent,
@@ -18401,7 +18576,9 @@ function ChatInterfaceWithAgent({
       ChatHistory,
       {
         entries: chatHistory,
-        isConfirmationActive: !!confirmationOptions
+        isConfirmationActive: !!confirmationOptions,
+        verbosityLevel,
+        explainLevel
       }
     ) }),
     /* @__PURE__ */ jsx(
@@ -18433,7 +18610,6 @@ function ChatInterfaceWithAgent({
           progress: void 0
         }
       ),
-      /* @__PURE__ */ jsx(VersionNotification, { isVisible: !isProcessing && !isStreaming }),
       planMode.isActive && /* @__PURE__ */ jsx(Box, { marginBottom: 1, children: /* @__PURE__ */ jsx(
         PlanModeIndicator,
         {
@@ -18453,6 +18629,7 @@ function ChatInterfaceWithAgent({
           isStreaming
         }
       ),
+      /* @__PURE__ */ jsx(VersionNotification, { isVisible: !isProcessing && !isStreaming }),
       /* @__PURE__ */ jsxs(Box, { flexDirection: "row", marginTop: 1, children: [
         /* @__PURE__ */ jsxs(Box, { marginRight: 2, children: [
           /* @__PURE__ */ jsxs(Text, { color: "cyan", children: [
@@ -19020,7 +19197,7 @@ program.name("grok").description(
     checkAutoCompact();
     checkStartupUpdates();
     const initialMessage = Array.isArray(message) ? message.join(" ") : message;
-    const app = render(React2.createElement(ChatInterface, { agent, initialMessage }));
+    const app = render(React3.createElement(ChatInterface, { agent, initialMessage }));
     const cleanup = () => {
       app.unmount();
       agent.abortCurrentOperation();