@qodalis/cli 2.0.0-beta.14 → 2.0.0-beta.16

package/README.md

@@ -288,6 +288,7 @@ All three implement the same API surface:
 | `/ws/v1/cli/events` | WS | Server-push event streaming |
 | `/ws/v1/cli/shell` | WS | Interactive PTY shell session |
 | `/api/cli/fs/*` | Various | Filesystem operations (ls, cat, upload, download, mkdir, rm) |
+| `/api/qcli/mcp` | POST | MCP endpoint for AI clients (opt-in) |
 
 ### Connecting to a Server
 
@@ -320,6 +321,19 @@ The frontend includes built-in resilience features:
 - **HTTP retry** on transient fetch failures (1 retry with 1s delay)
 - **Configurable request timeout** per server (default 30s)
 
+### MCP
+
+Each server can expose the whole system to AI clients such as Claude Code over the [Model Context Protocol](https://modelcontextprotocol.io) at `POST /api/qcli/mcp` (opt-in): CLI commands, the filesystem API, the data explorer, jobs and plugin-contributed tools, each with the caller's permissions. It works with or without the users plugin, whose `token create` command issues the API tokens MCP clients sign in with:
+
+```bash
+# direct HTTP
+claude mcp add --transport http qcli http://localhost:8047/api/qcli/mcp --header "Authorization: Bearer <token>"
+# or the local stdio proxy @qodalis/mcp-cli (token or user/password, read-only mode, tool filters)
+claude mcp add qcli -e QCLI_URL=http://localhost:8047 -e QCLI_TOKEN=<token> -- npx -y @qodalis/mcp-cli
+```
+
+See [MCP endpoint](https://cli.qodalis.com/docs/server-integration#mcp-endpoint) for enabling it, the tools and permissions, and client setup.
+
 ### Server Plugins
 
 | Plugin | Servers | Description |

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@qodalis/cli",
-  "version": "2.0.0-beta.14",
+  "version": "2.0.0-beta.16",
   "description": "Framework-agnostic CLI engine for @qodalis terminal applications.",
   "author": "Nicolae Lupei, Qodalis Solutions",
   "license": "MIT",
@@ -30,7 +30,7 @@
     "./assets/*": "./assets/*"
   },
   "dependencies": {
-    "@qodalis/cli-core": "2.0.0-beta.14",
+    "@qodalis/cli-core": "2.0.0-beta.16",
     "@xterm/xterm": "^5.5.0",
     "@xterm/addon-fit": "^0.10.0",
     "@xterm/addon-web-links": "^0.11.0",

package/public-api.d.mts

@@ -153,7 +153,7 @@ declare const CliKeyValueStore_TOKEN = "cli-key-value-store";
  */
 declare const SyntaxHighlighterRegistry_TOKEN = "syntax-highlighter-registry";
 
-declare const LIBRARY_VERSION = "2.0.0-beta.14";
+declare const LIBRARY_VERSION = "2.0.0-beta.16";
 declare const API_VERSION = 2;
 
 declare class CliAliasCommandProcessor implements ICliCommandProcessor {

package/public-api.d.ts

@@ -153,7 +153,7 @@ declare const CliKeyValueStore_TOKEN = "cli-key-value-store";
  */
 declare const SyntaxHighlighterRegistry_TOKEN = "syntax-highlighter-registry";
 
-declare const LIBRARY_VERSION = "2.0.0-beta.14";
+declare const LIBRARY_VERSION = "2.0.0-beta.16";
 declare const API_VERSION = 2;
 
 declare class CliAliasCommandProcessor implements ICliCommandProcessor {

package/public-api.js

@@ -413,7 +413,7 @@ var CliKeyValueStore_TOKEN = "cli-key-value-store";
 var SyntaxHighlighterRegistry_TOKEN = "syntax-highlighter-registry";
 
 // src/lib/version.ts
-var LIBRARY_VERSION = "2.0.0-beta.14";
+var LIBRARY_VERSION = "2.0.0-beta.16";
 var API_VERSION = 2;
 var ANONYMOUS = "\0anonymous";
 function aliasOwner(context2) {
@@ -12344,8 +12344,6 @@ var CliClipboard = class {
     }
   }
 };
-
-// src/lib/input/modes/input-mode-base.ts
 var InputModeBase = class {
   constructor(host, resolve) {
     this.host = host;
@@ -12414,6 +12412,17 @@ var InputModeBase = class {
     }
     this.host.terminal.write(buf);
   }
+  /**
+   * Cut a line to the terminal width. Lines redrawn in place must stay on one row:
+   * a wrapped line takes two rows and breaks the cursor-up arithmetic of the redraw.
+   */
+  fitLine(text) {
+    return cliCore.truncateToWidth(text, Math.max(1, this.host.getTerminalCols() - 1));
+  }
+  /** Start a new row and write `text` cut to the terminal width. */
+  writeRow(text) {
+    this.host.terminal.write("\r\n" + this.fitLine(text));
+  }
   /**
    * Render a dimmed help bar below the current line.
    */
@@ -12421,7 +12430,7 @@ var InputModeBase = class {
     this.extraLines++;
     this.host.terminal.write(
       `\r
-    \x1B[2m${text}\x1B[0m\x1B[${this.extraLines}A`
+${this.fitLine(`    \x1B[2m${text}\x1B[0m`)}\x1B[${this.extraLines}A`
     );
   }
   /**
@@ -12431,7 +12440,7 @@ var InputModeBase = class {
     this.extraLines++;
     this.host.terminal.write(
       `\r
-  \x1B[31m\u2718 ${message}\x1B[0m\x1B[${this.extraLines}A`
+${this.fitLine(`  \x1B[31m\u2718 ${message}\x1B[0m`)}\x1B[${this.extraLines}A`
     );
   }
   /**
@@ -12933,15 +12942,15 @@ var SelectInputMode = class extends InputModeBase {
     if (this.selectOptions?.searchable) {
       if (this.filter.length > 0) {
         this.host.terminal.write(
-          `\x1B[36m?\x1B[0m ${this.promptText}: ${this.filter}`
+          this.fitLine(`\x1B[36m?\x1B[0m ${this.promptText}: ${this.filter}`)
         );
       } else {
         this.host.terminal.write(
-          `\x1B[36m?\x1B[0m ${this.promptText}: \x1B[2mType to filter...\x1B[0m`
+          this.fitLine(`\x1B[36m?\x1B[0m ${this.promptText}: \x1B[2mType to filter...\x1B[0m`)
         );
       }
     } else {
-      this.host.terminal.write(`\x1B[36m?\x1B[0m ${this.promptText}:`);
+      this.host.terminal.write(this.fitLine(`\x1B[36m?\x1B[0m ${this.promptText}:`));
     }
   }
   /**
@@ -12956,17 +12965,15 @@ var SelectInputMode = class extends InputModeBase {
       this.scrollOffset + this.maxVisible
     );
     if (visibleStart > 0) {
-      this.host.terminal.write(`\r
-\x1B[2m  \u2191 ${visibleStart} more above\x1B[0m`);
+      this.writeRow(`\x1B[2m  \u2191 ${visibleStart} more above\x1B[0m`);
       this.renderedLines++;
     }
     let selectableIdx = 0;
     for (const item of items) {
       if (item.type === "group-header") {
         if (this.isGroupVisible(item.groupName, items, visibleStart, visibleEnd)) {
-          this.host.terminal.write(
-            `\r
-\x1B[35m\u2500\u2500 ${item.groupName} \u2500\u2500\x1B[0m`
+          this.writeRow(
+            `\x1B[35m\u2500\u2500 ${item.groupName} \u2500\u2500\x1B[0m`
           );
           this.renderedLines++;
         }
@@ -12989,8 +12996,7 @@ var SelectInputMode = class extends InputModeBase {
     }
     const remaining = selectables.length - visibleEnd;
     if (remaining > 0) {
-      this.host.terminal.write(`\r
-\x1B[2m  \u2193 ${remaining} more below\x1B[0m`);
+      this.writeRow(`\x1B[2m  \u2193 ${remaining} more below\x1B[0m`);
       this.renderedLines++;
     }
   }
@@ -13032,19 +13038,16 @@ var SelectInputMode = class extends InputModeBase {
     const label = this.highlightMatch(opt.label);
     const desc = opt.description ? ` \x1B[2;3m\u2014 ${opt.description}\x1B[0m` : "";
     if (opt.disabled) {
-      this.host.terminal.write(
-        `\r
-    \x1B[2m${opt.label}${desc} (disabled)\x1B[0m`
+      this.writeRow(
+        `    \x1B[2m${opt.label}${desc} (disabled)\x1B[0m`
       );
     } else if (isSelected) {
-      this.host.terminal.write(
-        `\r
-  \x1B[48;5;24m\x1B[38;5;117m\u276F ${label}${desc}\x1B[0m`
+      this.writeRow(
+        `  \x1B[48;5;24m\x1B[38;5;117m\u276F ${label}${desc}\x1B[0m`
       );
     } else {
-      this.host.terminal.write(
-        `\r
-    ${label}${desc}`
+      this.writeRow(
+        `    ${label}${desc}`
       );
     }
   }
@@ -13078,8 +13081,7 @@ var SelectInputMode = class extends InputModeBase {
     } else {
       help = "\u2191/\u2193 navigate \xB7 enter to select \xB7 esc to cancel";
     }
-    this.host.terminal.write(`\r
-    \x1B[2m${help}\x1B[0m`);
+    this.writeRow(`    \x1B[2m${help}\x1B[0m`);
     this.renderedLines++;
   }
 };
@@ -13557,15 +13559,15 @@ var MultiSelectInputMode = class extends InputModeBase {
     if (this.selectOptions?.searchable) {
       if (this.filter.length > 0) {
         this.host.terminal.write(
-          `\x1B[36m?\x1B[0m ${this.promptText}: ${this.filter}`
+          this.fitLine(`\x1B[36m?\x1B[0m ${this.promptText}: ${this.filter}`)
         );
       } else {
         this.host.terminal.write(
-          `\x1B[36m?\x1B[0m ${this.promptText}: \x1B[2mType to filter...\x1B[0m`
+          this.fitLine(`\x1B[36m?\x1B[0m ${this.promptText}: \x1B[2mType to filter...\x1B[0m`)
         );
       }
     } else {
-      this.host.terminal.write(`\x1B[36m?\x1B[0m ${this.promptText}:`);
+      this.host.terminal.write(this.fitLine(`\x1B[36m?\x1B[0m ${this.promptText}:`));
     }
   }
   /**
@@ -13580,17 +13582,15 @@ var MultiSelectInputMode = class extends InputModeBase {
       this.scrollOffset + this.maxVisible
     );
     if (visibleStart > 0) {
-      this.host.terminal.write(`\r
-\x1B[2m  \u2191 ${visibleStart} more above\x1B[0m`);
+      this.writeRow(`\x1B[2m  \u2191 ${visibleStart} more above\x1B[0m`);
       this.renderedLines++;
     }
     let selectableIdx = 0;
     for (const item of items) {
       if (item.type === "group-header") {
         if (this.isGroupVisible(item.groupName, items, visibleStart, visibleEnd)) {
-          this.host.terminal.write(
-            `\r
-\x1B[35m\u2500\u2500 ${item.groupName} \u2500\u2500\x1B[0m`
+          this.writeRow(
+            `\x1B[35m\u2500\u2500 ${item.groupName} \u2500\u2500\x1B[0m`
           );
           this.renderedLines++;
         }
@@ -13613,8 +13613,7 @@ var MultiSelectInputMode = class extends InputModeBase {
     }
     const remaining = selectables.length - visibleEnd;
     if (remaining > 0) {
-      this.host.terminal.write(`\r
-\x1B[2m  \u2193 ${remaining} more below\x1B[0m`);
+      this.writeRow(`\x1B[2m  \u2193 ${remaining} more below\x1B[0m`);
       this.renderedLines++;
     }
   }
@@ -13659,19 +13658,16 @@ var MultiSelectInputMode = class extends InputModeBase {
     const checkbox = isChecked ? "\x1B[32m\u25C9\x1B[0m" : "\x1B[2m\u25CB\x1B[0m";
     if (opt.disabled) {
       const disabledCheckbox = isChecked ? "\x1B[2m\u25C9\x1B[0m" : "\x1B[2m\u25CB\x1B[0m";
-      this.host.terminal.write(
-        `\r
-    ${disabledCheckbox} \x1B[2m${opt.label}${desc} (disabled)\x1B[0m`
+      this.writeRow(
+        `    ${disabledCheckbox} \x1B[2m${opt.label}${desc} (disabled)\x1B[0m`
       );
     } else if (isSelected) {
-      this.host.terminal.write(
-        `\r
-  \x1B[48;5;24m\x1B[38;5;117m\u276F ${checkbox} ${label}${desc}\x1B[0m`
+      this.writeRow(
+        `  \x1B[48;5;24m\x1B[38;5;117m\u276F ${checkbox} ${label}${desc}\x1B[0m`
       );
     } else {
-      this.host.terminal.write(
-        `\r
-    ${checkbox} ${label}${desc}`
+      this.writeRow(
+        `    ${checkbox} ${label}${desc}`
       );
     }
   }
@@ -13706,8 +13702,7 @@ var MultiSelectInputMode = class extends InputModeBase {
     } else {
       help = `${checkedCount} selected \xB7 space to toggle \xB7 a to select all \xB7 enter to confirm`;
     }
-    this.host.terminal.write(`\r
-    \x1B[2m${help}\x1B[0m`);
+    this.writeRow(`    \x1B[2m${help}\x1B[0m`);
     this.renderedLines++;
   }
 };