npm - @mtreeai/msapling-cli - Versions diffs - 2.3.6-beta.54 → 2.3.6-beta.56 - Mend

@mtreeai/msapling-cli 2.3.6-beta.54 → 2.3.6-beta.56

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (4) hide show

package/LICENSE CHANGED Viewed

@@ -1,44 +1,44 @@
-MSapling CLI — Proprietary License
-Copyright (c) 2026 MSapling / MTreeAI. All rights reserved.
-This software, the source code in this repository, and the published
-`@mtreeai/msapling-cli` and `msapling` npm packages (collectively, "the Software") are the
-proprietary property of MSapling / MTreeAI.
-PERMITTED USE
--------------
-You may:
-  1. Install and run the published binary distribution of the Software
-     ("msapling" / "ms" CLI) for personal or internal-business use against
-     the official MSapling backend at https://api.msapling.com.
-  2. Configure the Software with your own API keys (BYOK) and local model
-     providers (Ollama, etc.) as supported by the Software's documented
-     features.
-PROHIBITED USE
---------------
-Without prior written permission from MSapling / MTreeAI you may not:
-  1. Copy, fork, mirror, redistribute, sublicense, or republish the Software
-     or any substantial portion of its source code or compiled artifacts.
-  2. Reverse-engineer, decompile, or disassemble the Software except to the
-     extent permitted by applicable law that cannot be contractually waived.
-  3. Use the Software to operate a competing service or to circumvent any
-     authentication, billing, rate-limiting, or tier-gating mechanism of the
-     MSapling backend.
-  4. Remove or alter any copyright notice, trademark, or proprietary legend
-     embedded in the Software.
-NO WARRANTY
------------
-THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-FITNESS FOR A PARTICULAR PURPOSE, AND NON-INFRINGEMENT. IN NO EVENT SHALL
-THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES, OR OTHER
-LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT, OR OTHERWISE, ARISING
-FROM, OUT OF, OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER
-DEALINGS IN THE SOFTWARE.
-CONTACT
--------
-For licensing inquiries, partnership requests, or permission to redistribute:
-https://msapling.com/support
+MSapling CLI — Proprietary License
+Copyright (c) 2026 MSapling / MTreeAI. All rights reserved.
+This software, the source code in this repository, and the published
+`@mtreeai/msapling-cli` and `msapling` npm packages (collectively, "the Software") are the
+proprietary property of MSapling / MTreeAI.
+PERMITTED USE
+-------------
+You may:
+  1. Install and run the published binary distribution of the Software
+     ("msapling" / "ms" CLI) for personal or internal-business use against
+     the official MSapling backend at https://api.msapling.com.
+  2. Configure the Software with your own API keys (BYOK) and local model
+     providers (Ollama, etc.) as supported by the Software's documented
+     features.
+PROHIBITED USE
+--------------
+Without prior written permission from MSapling / MTreeAI you may not:
+  1. Copy, fork, mirror, redistribute, sublicense, or republish the Software
+     or any substantial portion of its source code or compiled artifacts.
+  2. Reverse-engineer, decompile, or disassemble the Software except to the
+     extent permitted by applicable law that cannot be contractually waived.
+  3. Use the Software to operate a competing service or to circumvent any
+     authentication, billing, rate-limiting, or tier-gating mechanism of the
+     MSapling backend.
+  4. Remove or alter any copyright notice, trademark, or proprietary legend
+     embedded in the Software.
+NO WARRANTY
+-----------
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE, AND NON-INFRINGEMENT. IN NO EVENT SHALL
+THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES, OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT, OR OTHERWISE, ARISING
+FROM, OUT OF, OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER
+DEALINGS IN THE SOFTWARE.
+CONTACT
+-------
+For licensing inquiries, partnership requests, or permission to redistribute:
+https://msapling.com/support

package/README.md CHANGED Viewed

@@ -1,174 +1,174 @@
-# MSapling CLI
-MSapling CLI is the React/TypeScript terminal client for the MSapling backend.
-## Install
-Install the MSapling CLI globally via npm:
-```bash
-npm install -g msapling@beta
-```
-**Requirements:** Node.js 20.10 or higher.
-The short `msapling` package and compatibility package `@mtreeai/msapling-cli` contain the same CLI bundle. Both use the `beta` dist-tag during prerelease testing.
-## First Run
-Start the interactive REPL:
-```bash
-msapling
-```
-Inside the REPL, authenticate using one of these methods:
-```
-/login your@email.com    # Email + password login (with optional 2FA)
-/login github            # GitHub device flow (opens browser)
-/login <token>           # Paste an API token from msapling.com Settings
-```
-All methods store the token via the OS keychain (Windows DPAPI, macOS Keychain, or Linux libsecret).
-Once logged in, start chatting:
-```
-/chat hello
-```
-## CLI Subcommands (argv)
-These are passed directly on the command line before the REPL starts:
-| Command | Description |
-|---------|-------------|
-| *(none)* | Start interactive REPL |
-| `--compact` | Start REPL in compact mode (thin separators, no footer) |
-| `mcp serve` | Run as MCP stdio server (Claude Code / Cursor / Windsurf integration) |
-| `--version` | Print version and exit |
-| `--help` | Print usage and exit |
-## Inside the REPL — Slash Commands
-Once the REPL is running, type `/help` to see all available slash commands. Common ones:
-| Slash Command | Description |
-|---------------|-------------|
-| `/login your@email.com` | Sign in with email + password (recommended for end users) |
-| `/login github` | GitHub device flow (for developers) |
-| `/login <token>` | Paste an API token from Settings → API Keys |
-| `/logout` | Clear stored token |
-| `/chat <message>` | Send a message and stream a response |
-| `/chat new <title>` | Create a chat inside the fixed CLI project |
-| `/chat import <chat_id>` | Copy another owned chat into a new CLI chat without mutating the source |
-| `/model` | Open the loopback visual catalog (complete LAB catalog remotely; direct provider catalog standalone) |
-| `/model --terminal` | Use the provider-first terminal selector instead |
-| `/keys add <provider>` | Enter a BYOK key through hidden terminal input or the one-time local browser prompt |
-| `/keys use <provider> [base_url]` | Select OpenRouter or an OpenAI-compatible provider in standalone mode |
-| `/footer [compact|expanded|field on|off]` | Configure telemetry visibility |
-| `/cost` | Show usage and billing data |
-| `/config` | View and edit configuration |
-| `/help` | Show all slash-command help |
-> **Note:** `chat`, `login`, `model`, `footer`, `cost`, and `config` are REPL slash-commands (prefixed with `/`), not top-level argv subcommands. The CLI is single-chat: fanout/swarm commands are hidden and disabled. Run `msapling --help` to see the argv interface.
-See `packages/cli/src/commands/index.ts` for the canonical slash-command list.
----
-The installed CLI has explicit remote and standalone profiles. In remote mode, MSapling's backend is the source of truth for auth, projects, chats, model routing, usage, billing, MDrive, locks, and audit data. In `--local` mode, model calls, provider keys, transcripts, tools, and project settings remain local and LAB is not contacted for turns.
-## Product Direction
-MSapling started as a multi-chat browser workspace: multiple AI chats, many model choices, BYOK, OpenRouter, and Ollama support in one UI.
-The mobile app extends that shared workspace to one-chat-at-a-time usage and phone-first workflows such as sending a photo into a chat.
-The CLI uses the same backend state through a fixed project named `CLI` and one active chat at a time. It should be fast, low-resource, and useful without duplicating the backend.
-## Architecture
-```text
-Website     \
-Mobile App   ->  MSapling Backend  ->  chats, projects, usage, billing, MDrive, locks
-CLI         /
-```
-The CLI should:
-- authenticate with the backend
-  - read the fixed `CLI` project and active chat from the backend
-- stream chat responses from `/api/chat/message`
-- display backend usage and quota data
-- respect backend stream locks
-- use backend MDrive/edit proposal flows
-- keep local terminal work lightweight
-The CLI should not:
-  - invent separate chat state or switch arbitrary web chats
-  - expose multi-chat/swarm fanout commands
-- compute billing locally
-- simulate MDrive state
-- bypass backend locks
-- duplicate backend orchestration unless there is a clear reason
-## Current State
-This directory is a Bun monorepo scaffold using React and Ink.
-Port useful behavior selectively. Do not port backend-like responsibilities.
-Known current gaps:
-- workspace package manifests are missing
-- the Ink input loop is incomplete
-- `Agent` is referenced but not implemented
-- MDrive logic is simulated locally
-- backend route contracts need to be aligned
-- tests and build are not yet passing
-## Near-Term Goal
-Build a stable thin client:
-1. Login and secure token storage.
-2. Fetch backend project overview.
-3. Open or create chats.
-4. Stream backend chat responses.
-5. Show shared chat history across website, app, and CLI.
-6. Handle lock, quota, and auth errors clearly.
-7. Add `/doctor`.
-## Commands
-```bash
-bun install
-bun run build
-bun test
-bun run start
-```
-These commands are target commands. They may not pass until the workspace manifests and dependencies are completed.
-## Environment
-```bash
-MSAPLING_API_URL=https://api.msapling.com
-```
-For local development, point `MSAPLING_API_URL` at the local backend.
-## Design Principle
-Keep the CLI small.
-The backend should do the heavy work. The CLI should make that backend fast and comfortable from a terminal.
----
-**Full architecture overview:** see ARCHITECTURE.md (when published) or `packages/core/README.md`.
+# MSapling CLI
+MSapling CLI is the React/TypeScript terminal client for the MSapling backend.
+## Install
+Install the MSapling CLI globally via npm:
+```bash
+npm install -g msapling@beta
+```
+**Requirements:** Node.js 20.10 or higher.
+The short `msapling` package and compatibility package `@mtreeai/msapling-cli` contain the same CLI bundle. Both use the `beta` dist-tag during prerelease testing.
+## First Run
+Start the interactive REPL:
+```bash
+msapling
+```
+Inside the REPL, authenticate using one of these methods:
+```
+/login your@email.com    # Email + password login (with optional 2FA)
+/login github            # GitHub device flow (opens browser)
+/login <token>           # Paste an API token from msapling.com Settings
+```
+All methods store the token via the OS keychain (Windows DPAPI, macOS Keychain, or Linux libsecret).
+Once logged in, start chatting:
+```
+/chat hello
+```
+## CLI Subcommands (argv)
+These are passed directly on the command line before the REPL starts:
+| Command | Description |
+|---------|-------------|
+| *(none)* | Start interactive REPL |
+| `--compact` | Start REPL in compact mode (thin separators, no footer) |
+| `mcp serve` | Run as MCP stdio server (Claude Code / Cursor / Windsurf integration) |
+| `--version` | Print version and exit |
+| `--help` | Print usage and exit |
+## Inside the REPL — Slash Commands
+Once the REPL is running, type `/help` to see all available slash commands. Common ones:
+| Slash Command | Description |
+|---------------|-------------|
+| `/login your@email.com` | Sign in with email + password (recommended for end users) |
+| `/login github` | GitHub device flow (for developers) |
+| `/login <token>` | Paste an API token from Settings → API Keys |
+| `/logout` | Clear stored token |
+| `/chat <message>` | Send a message and stream a response |
+| `/chat new <title>` | Create a chat inside the fixed CLI project |
+| `/chat import <chat_id>` | Copy another owned chat into a new CLI chat without mutating the source |
+| `/model` | Open the loopback visual catalog (complete LAB catalog remotely; direct provider catalog standalone) |
+| `/model --terminal` | Use the provider-first terminal selector instead |
+| `/keys add <provider>` | Enter a BYOK key through hidden terminal input or the one-time local browser prompt |
+| `/keys use <provider> [base_url]` | Select OpenRouter or an OpenAI-compatible provider in standalone mode |
+| `/footer [compact|expanded|field on|off]` | Configure telemetry visibility |
+| `/cost` | Show usage and billing data |
+| `/config` | View and edit configuration |
+| `/help` | Show all slash-command help |
+> **Note:** `chat`, `login`, `model`, `footer`, `cost`, and `config` are REPL slash-commands (prefixed with `/`), not top-level argv subcommands. The CLI is single-chat: fanout/swarm commands are hidden and disabled. Run `msapling --help` to see the argv interface.
+See `packages/cli/src/commands/index.ts` for the canonical slash-command list.
+---
+The installed CLI has explicit remote and standalone profiles. In remote mode, MSapling's backend is the source of truth for auth, projects, chats, model routing, usage, billing, MDrive, locks, and audit data. In `--local` mode, model calls, provider keys, transcripts, tools, and project settings remain local and LAB is not contacted for turns.
+## Product Direction
+MSapling started as a multi-chat browser workspace: multiple AI chats, many model choices, BYOK, OpenRouter, and Ollama support in one UI.
+The mobile app extends that shared workspace to one-chat-at-a-time usage and phone-first workflows such as sending a photo into a chat.
+The CLI uses the same backend state through a fixed project named `CLI` and one active chat at a time. It should be fast, low-resource, and useful without duplicating the backend.
+## Architecture
+```text
+Website     \
+Mobile App   ->  MSapling Backend  ->  chats, projects, usage, billing, MDrive, locks
+CLI         /
+```
+The CLI should:
+- authenticate with the backend
+  - read the fixed `CLI` project and active chat from the backend
+- stream chat responses from `/api/chat/message`
+- display backend usage and quota data
+- respect backend stream locks
+- use backend MDrive/edit proposal flows
+- keep local terminal work lightweight
+The CLI should not:
+  - invent separate chat state or switch arbitrary web chats
+  - expose multi-chat/swarm fanout commands
+- compute billing locally
+- simulate MDrive state
+- bypass backend locks
+- duplicate backend orchestration unless there is a clear reason
+## Current State
+This directory is a Bun monorepo scaffold using React and Ink.
+Port useful behavior selectively. Do not port backend-like responsibilities.
+Known current gaps:
+- workspace package manifests are missing
+- the Ink input loop is incomplete
+- `Agent` is referenced but not implemented
+- MDrive logic is simulated locally
+- backend route contracts need to be aligned
+- tests and build are not yet passing
+## Near-Term Goal
+Build a stable thin client:
+1. Login and secure token storage.
+2. Fetch backend project overview.
+3. Open or create chats.
+4. Stream backend chat responses.
+5. Show shared chat history across website, app, and CLI.
+6. Handle lock, quota, and auth errors clearly.
+7. Add `/doctor`.
+## Commands
+```bash
+bun install
+bun run build
+bun test
+bun run start
+```
+These commands are target commands. They may not pass until the workspace manifests and dependencies are completed.
+## Environment
+```bash
+MSAPLING_API_URL=https://api.msapling.com
+```
+For local development, point `MSAPLING_API_URL` at the local backend.
+## Design Principle
+Keep the CLI small.
+The backend should do the heavy work. The CLI should make that backend fast and comfortable from a terminal.
+---
+**Full architecture overview:** see ARCHITECTURE.md (when published) or `packages/core/README.md`.

package/dist/index.js CHANGED Viewed

@@ -15483,6 +15483,84 @@ var init_exit = __esm({
   }
 });
+// src/commands/billing/open-browser.ts
+import { spawn as spawn10 } from "child_process";
+function isSafeBrowserUrl(url) {
+  if (typeof url !== "string" || url.length === 0 || url.length > 4096) return false;
+  for (let index = 0; index < url.length; index++) {
+    const code = url.charCodeAt(index);
+    if (code <= 32 || code === 127 || code === 34 || code === 92 || code === 96) return false;
+  }
+  try {
+    const parsed = new URL(url);
+    return parsed.protocol === "https:" || parsed.protocol === "http:";
+  } catch {
+    return false;
+  }
+}
+function hasGraphicalBrowserEnvironment(platform5 = process.platform, env = process.env) {
+  if (platform5 === "win32" || platform5 === "darwin") return true;
+  return Boolean(env.DISPLAY || env.WAYLAND_DISPLAY);
+}
+async function openBrowser(url, launch = spawn10) {
+  if (!isSafeBrowserUrl(url)) return false;
+  const platform5 = process.platform;
+  const [command, args2] = platform5 === "win32" ? ["rundll32.exe", ["url.dll,FileProtocolHandler", url]] : platform5 === "darwin" ? ["open", [url]] : ["xdg-open", [url]];
+  return new Promise((resolve23) => {
+    let settled = false;
+    const finish = (opened) => {
+      if (settled) return;
+      settled = true;
+      resolve23(opened);
+    };
+    try {
+      const child = launch(command, [...args2], { stdio: "ignore", detached: true });
+      child.once("error", () => finish(false));
+      child.once("spawn", () => {
+        child.unref();
+        finish(true);
+      });
+    } catch {
+      finish(false);
+    }
+  });
+}
+var init_open_browser = __esm({
+  "src/commands/billing/open-browser.ts"() {
+    "use strict";
+    init_esm_shims();
+  }
+});
+// src/runtime/webLinks.ts
+function msaplingWebUrl(path3, env = process.env) {
+  const configured = (env.MSAPLING_WEB_URL ?? DEFAULT_WEB_ORIGIN).trim();
+  const origin = new URL(configured);
+  const local = origin.hostname === "localhost" || origin.hostname === "127.0.0.1";
+  if (origin.protocol !== "https:" && !(local && origin.protocol === "http:")) {
+    throw new Error("MSAPLING_WEB_URL must use HTTPS (HTTP is allowed only for localhost)");
+  }
+  if (origin.username || origin.password || origin.search || origin.hash) {
+    throw new Error("MSAPLING_WEB_URL must be an origin without credentials, query, or fragment");
+  }
+  return new URL(path3.startsWith("/") ? path3 : `/${path3}`, `${origin.origin}/`).toString();
+}
+function cliHelpUrl(env) {
+  return msaplingWebUrl("/cli/help", env);
+}
+function cliChatUrl(chatId, env) {
+  if (!/^[A-Za-z0-9_-]{1,128}$/.test(chatId)) throw new Error("Invalid CLI chat id");
+  return msaplingWebUrl(`/chat/${encodeURIComponent(chatId)}`, env);
+}
+var DEFAULT_WEB_ORIGIN;
+var init_webLinks = __esm({
+  "src/runtime/webLinks.ts"() {
+    "use strict";
+    init_esm_shims();
+    DEFAULT_WEB_ORIGIN = "https://msapling.com";
+  }
+});
 // src/commands/help.ts
 function getDisplayCategory(cmd) {
   return DISPLAY_CATEGORIES[cmd.name] ?? cmd.category ?? "Other";
@@ -15493,6 +15571,8 @@ var init_help = __esm({
     "use strict";
     init_esm_shims();
     init_commands();
+    init_open_browser();
+    init_webLinks();
     DISPLAY_CATEGORIES = {
       // Navigation
       chat: "Navigation",
@@ -15531,9 +15611,20 @@ var init_help = __esm({
     CATEGORY_ORDER = ["Navigation", "Chat", "Tools", "Config", "Export/Import", "System"];
     helpCommand = {
       name: "help",
-      description: "Show available commands grouped by category",
+      args: "[--web|--terminal]",
+      description: "Open searchable CLI help or list commands in the terminal",
       category: "debug",
-      handler: (_args, context) => {
+      handler: async (args2, context) => {
+        const forceWeb = args2[0]?.toLowerCase() === "--web";
+        const forceTerminal = args2[0]?.toLowerCase() === "--terminal";
+        if (!forceTerminal && (forceWeb || process.stdout.isTTY && hasGraphicalBrowserEnvironment())) {
+          const url = cliHelpUrl();
+          if (await openBrowser(url)) {
+            context.addMessage("system", "CLI help opened on msapling.com.");
+            return;
+          }
+          if (forceWeb) context.addMessage("error", `Could not open a browser. Visit ${url}`);
+        }
         context.addMessage("system", "Available Commands:");
         const grouped = {};
         for (const cmd of commands) {
@@ -15838,55 +15929,6 @@ var init_resume = __esm({
   }
 });
-// src/commands/billing/open-browser.ts
-import { spawn as spawn10 } from "child_process";
-function isSafeBrowserUrl(url) {
-  if (typeof url !== "string" || url.length === 0 || url.length > 4096) return false;
-  for (let index = 0; index < url.length; index++) {
-    const code = url.charCodeAt(index);
-    if (code <= 32 || code === 127 || code === 34 || code === 92 || code === 96) return false;
-  }
-  try {
-    const parsed = new URL(url);
-    return parsed.protocol === "https:" || parsed.protocol === "http:";
-  } catch {
-    return false;
-  }
-}
-function hasGraphicalBrowserEnvironment(platform5 = process.platform, env = process.env) {
-  if (platform5 === "win32" || platform5 === "darwin") return true;
-  return Boolean(env.DISPLAY || env.WAYLAND_DISPLAY);
-}
-async function openBrowser(url, launch = spawn10) {
-  if (!isSafeBrowserUrl(url)) return false;
-  const platform5 = process.platform;
-  const [command, args2] = platform5 === "win32" ? ["rundll32.exe", ["url.dll,FileProtocolHandler", url]] : platform5 === "darwin" ? ["open", [url]] : ["xdg-open", [url]];
-  return new Promise((resolve23) => {
-    let settled = false;
-    const finish = (opened) => {
-      if (settled) return;
-      settled = true;
-      resolve23(opened);
-    };
-    try {
-      const child = launch(command, [...args2], { stdio: "ignore", detached: true });
-      child.once("error", () => finish(false));
-      child.once("spawn", () => {
-        child.unref();
-        finish(true);
-      });
-    } catch {
-      finish(false);
-    }
-  });
-}
-var init_open_browser = __esm({
-  "src/commands/billing/open-browser.ts"() {
-    "use strict";
-    init_esm_shims();
-  }
-});
 // src/runtime/modelPickerArtifact.ts
 import { randomBytes as randomBytes15, timingSafeEqual } from "crypto";
 import { createServer } from "http";
@@ -16097,6 +16139,9 @@ var init_projectSettings = __esm({
 function resetModelCatalogCache() {
   catalogCache = /* @__PURE__ */ new WeakMap();
 }
+function modelPickerReadyMessage(_secretUrl) {
+  return "Model picker opened in your browser (expires in five minutes).";
+}
 function price(value) {
   if (value === void 0 || value === null || value === "") return "?";
   const n2 = typeof value === "string" ? Number.parseFloat(value) : value;
@@ -16230,7 +16275,9 @@ var init_model = __esm({
                 contextLength: model2.context_length ?? null
               }));
               const selected = context.pickModel ? await context.pickModel(pickerRows, current) : await openModelPicker(pickerRows, current, {
-                onReady: (url) => context.addMessage("system", `Model picker: ${url}`)
+                // The URL fragment contains the one-time API credential. The
+                // browser receives it directly; never persist it in chat logs.
+                onReady: (url) => context.addMessage("system", modelPickerReadyMessage(url))
               });
               if (!selected) {
                 context.addMessage("system", "Model selection cancelled or expired.");
@@ -18328,14 +18375,34 @@ var init_history2 = __esm({
   "src/commands/history.ts"() {
     "use strict";
     init_esm_shims();
+    init_open_browser();
+    init_webLinks();
     historyCommand = {
       name: "history",
       aliases: ["hist"],
-      args: "[N]",
-      description: "Print the last N messages without virtualization (default 50)",
+      args: "[--web|--terminal] [N]",
+      description: "Open the complete active chat on MSapling or print its last N messages",
       category: "chat",
-      handler: (args2, context) => {
-        const n2 = args2[0] ? parseInt(args2[0], 10) : 50;
+      handler: async (args2, context) => {
+        const forceWeb = args2[0]?.toLowerCase() === "--web";
+        const forceTerminal = args2[0]?.toLowerCase() === "--terminal";
+        const remaining = forceWeb || forceTerminal ? args2.slice(1) : args2;
+        const shouldOpenWeb = context.executionMode !== "local" && Boolean(context.activeChatId) && !forceTerminal && (forceWeb || remaining.length === 0 && process.stdout.isTTY && hasGraphicalBrowserEnvironment());
+        if (shouldOpenWeb) {
+          const url = cliChatUrl(context.activeChatId);
+          if (await openBrowser(url)) {
+            context.addMessage("system", "Complete CLI chat opened on msapling.com.");
+            return;
+          }
+          if (forceWeb) context.addMessage("error", `Could not open a browser. Visit ${url}`);
+        } else if (forceWeb && context.executionMode === "local") {
+          context.addMessage("error", "Standalone history is local-only. Use /history --terminal [N].");
+          return;
+        } else if (forceWeb && !context.activeChatId) {
+          context.addMessage("error", "No active CLI chat to open.");
+          return;
+        }
+        const n2 = remaining[0] ? parseInt(remaining[0], 10) : 50;
         if (isNaN(n2) || n2 <= 0) {
           context.addMessage("system", "Usage: /history [N]  \u2014 N must be a positive integer");
           return;
@@ -18599,7 +18666,7 @@ var init_version = __esm({
       description: "Show version information for CLI and core packages",
       category: "debug",
       handler: async (_args, context) => {
-        const cliVersion = true ? "2.3.6-beta.54" : "(dev)";
+        const cliVersion = true ? "2.3.6-beta.56" : "(dev)";
         const coreVersion = true ? "2.3.6-beta.43" : "(dev)";
         const runtime = process.version;
         context.addMessage("system", "MSapling Version Info");
@@ -18608,7 +18675,7 @@ var init_version = __esm({
         context.addMessage("system", row2("Core (@msapling/core)", coreVersion));
         context.addMessage("system", row2("Runtime (Node/Bun)", runtime));
         try {
-          const ts = "2026-08-12T06:13:46.315Z";
+          const ts = "2026-08-12T21:55:24.426Z";
           if (ts && ts !== "__BUILD_TIMESTAMP__") {
             context.addMessage("system", row2("Build Timestamp", ts));
           }
@@ -23122,7 +23189,7 @@ import { jsx, jsxs } from "react/jsx-runtime";
 var Header = () => /* @__PURE__ */ jsxs(Box, { borderStyle: "single", borderColor: "cyan", paddingX: 1, marginBottom: 1, children: [
   /* @__PURE__ */ jsxs(Text, { bold: true, color: "cyan", children: [
     "\u25CF MSapling CLI v",
-    "2.3.6-beta.54"
+    "2.3.6-beta.56"
   ] }),
   /* @__PURE__ */ jsx(Box, { marginLeft: 2, children: /* @__PURE__ */ jsx(Text, { color: "gray", children: "Platinum Tier Architecture" }) })
 ] });

package/package.json CHANGED Viewed

@@ -1,6 +1,6 @@
 {
   "name": "@mtreeai/msapling-cli",
-  "version": "2.3.6-beta.54",
+  "version": "2.3.6-beta.56",
   "description": "MSapling CLI — React/Ink terminal client for the MSapling backend (chat, projects, MDrive, agent tools). Proprietary; redistribution prohibited.",
   "license": "SEE LICENSE IN LICENSE",
   "author": "MSapling Team",