tabby-bianbu-mcp 0.3.1 → 0.4.0

package/CHANGELOG.md

@@ -0,0 +1,19 @@
+# Changelog
+
+All notable changes to `tabby-bianbu-mcp` will be documented in this file.
+
+## [0.4.0] - 2026-03-19
+
+### Added
+- release asset sync pipeline for the remote installer script
+- remote diagnostics and push-upgrade workflow from the settings page
+- persistent MCP shell session support with fallback for older servers
+- packaged remote installer metadata for version comparison and release verification
+- node-based release tests and verification scripts
+- remote backup restore command via `restore-latest`
+
+### Changed
+- file rename now prefers remote atomic rename support when available
+- build pipeline now emits declaration files into `dist/`
+- README expanded with release and remote maintenance guidance
+- remote installer upgraded with richer health/version metadata, hash verification, safer backup behavior, and a secure default for passwordless sudo

package/LICENSE

@@ -1,21 +1,21 @@
-MIT License
-
-Copyright (c) 2026
-
-Permission is hereby granted, free of charge, to any person obtaining a copy
-of this software and associated documentation files (the "Software"), to deal
-in the Software without restriction, including without limitation the rights
-to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
-copies of the Software, and to permit persons to whom the Software is
-furnished to do so, subject to the following conditions:
-
-The above copyright notice and this permission notice shall be included in all
-copies or substantial portions of the Software.
-
-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 NONINFRINGEMENT. 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.
+MIT License
+
+Copyright (c) 2026 niver2002
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+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 NONINFRINGEMENT. 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.

package/README.md

@@ -1,82 +1,108 @@
-# tabby-bianbu-mcp
-
-A Tabby plugin that adds polished Bianbu Cloud remote tabs backed by your MCP endpoint.
-
-What it provides:
-- a dedicated `Bianbu MCP` settings page inside Tabby
-- `Bianbu Cloud Shell` and `Bianbu Cloud Files` entries integrated into Tabby's tab/profile flow
-- a terminal-based shell experience backed by MCP `run_command`
-- an explorer-like file manager backed by MCP file tools
-- connection fields for MCP URL, `X-API-KEY`, pacing, retries, and notes
-- quick actions and copyable config snippets
-
-Important:
-- this plugin does **not** implement native SSH or native SFTP transport
-- instead, it uses your Bianbu Cloud MCP endpoint at `https://<domain>/mcp`
-- `Bianbu Cloud Shell` is backed by MCP `run_command`
-- `Bianbu Cloud Files` is backed by MCP file tools such as `list_directory`, `read_text_file`, `write_text_file`, `upload_binary_file`, and `download_binary_file`
-
-## UI overview
-
-Inside Tabby, the plugin adds:
-
-### 1. Bianbu MCP settings page
-Fields:
-- enable integration
-- profile name
-- MCP URL
-- X-API-KEY
-- request interval (ms)
-- max retries
-- retry base delay (ms)
-- notes
-
-### 2. Bianbu Cloud Shell tab
-Features:
-- command input
-- working directory input
-- timeout input
-- `as_root` toggle
-- output history with stdout/stderr blocks
-
-### 3. Bianbu Cloud Files tab
-Features:
-- directory browser
-- open text files
-- edit and save text files
-- create directories and files
-- upload files
-- download files
-- delete files/directories
-- `as_root` toggle
-
-## Package
-
-- npm: `tabby-bianbu-mcp`
-- keyword: `tabby-plugin`
-
-## Build
-
-```bash
-npm install
-npm run build
-```
-
-## Publish
-
-```bash
-npm publish --access public
-```
-
-## Installability in Tabby
-
-This package is intended to be discoverable by Tabby's plugin manager through npm publication.
-Because Tabby's plugin discovery behavior can lag behind npm indexing, it may take a bit of time before search results update.
-
-## Source repository
-
-https://github.com/niver2002/tabby-bianbu-mcp
-
-## License
-
-MIT
+# tabby-bianbu-mcp
+
+A Tabby plugin for Bianbu Cloud remote shell and file operations over MCP.
+
+It adds a dedicated Bianbu MCP settings page, a shell-like terminal tab, a file manager tab, remote health diagnostics, and a bundled installer push-upgrade flow for the matching Bianbu Cloud MCP server.
+
+## Features
+
+- Bianbu MCP settings page inside Tabby
+- Bianbu Cloud Shell and Bianbu Cloud Files profiles
+- shell experience backed by MCP `run_command` and logical shell sessions
+- file explorer backed by MCP file tools
+- remote diagnostics: health, versions, capabilities, FILE_ROOT, transport mode
+- packaged remote installer asset with SHA-256 metadata and integrity verification
+- push latest installer to the remote host and trigger `up` or `repair`
+- chunked upload and download support for larger files
+- atomic rename support through MCP `rename_path`
+- remote backup and `restore-latest` recovery support in the installer
+
+## What this plugin is not
+
+- not native SSH
+- not native SFTP
+- not a replacement for the upstream Bianbu Cloud gateway authentication layer
+
+The plugin talks to a Bianbu Cloud MCP endpoint such as:
+
+`https://<domain>/mcp`
+
+Authentication relies on the existing upstream `X-API-KEY` layer. The plugin does not add a second proxy token layer.
+
+## Settings
+
+The plugin stores these main settings under `bianbuMcp`:
+
+- `enabled`
+- `name`
+- `url`
+- `apiKey`
+- `minIntervalMs`
+- `maxRetries`
+- `retryBaseMs`
+- `notes`
+- `installerRemotePath`
+- `maintenanceAsRoot`
+- `reconnectPollMs`
+- `upgradeHealthTimeoutMs`
+
+## Remote maintenance flow
+
+The plugin package contains a bundled copy of `bianbu_agent_proxy.sh` plus release metadata.
+
+When you click `Push latest installer + upgrade`:
+
+1. the plugin uploads the bundled installer to `installerRemotePath`
+2. it makes the script executable remotely
+3. it starts the installer in the background with `up` or `repair`
+4. it polls the MCP endpoint until health returns
+5. it shows the reported remote script version and server version
+
+This is the intended commercial-release upgrade path because the client and remote installer ship together.
+
+The remote installer now defaults `ENABLE_PASSWORDLESS_SUDO=false`. If you want unattended `as_root=true` maintenance through MCP, opt in explicitly and understand the security trade-off.
+
+## Build
+
+```bash
+npm install
+npm run build
+```
+
+## Test
+
+```bash
+npm test
+```
+
+## Release verification
+
+```bash
+npm run sync:remote-assets
+npm test
+npm run build
+npm pack --dry-run
+```
+
+## Publish
+
+```bash
+npm publish --access public
+```
+
+## Files included in the package
+
+- `dist/`
+- `assets/bianbu_agent_proxy.sh`
+- `assets/bianbu_agent_proxy.meta.json`
+- `README.md`
+- `LICENSE`
+- `CHANGELOG.md`
+
+## Source repository
+
+https://github.com/niver2002/tabby-bianbu-mcp
+
+## License
+
+MIT

package/assets/bianbu_agent_proxy.meta.json

@@ -0,0 +1,9 @@
+{
+  "fileName": "bianbu_agent_proxy.sh",
+  "sourceFile": "bianbu_agent_proxy.sh",
+  "scriptVersion": "1.2.0",
+  "serverVersion": "1.2.0",
+  "sha256": "d4f21b824acf3f73356977706da8c5917ec7832903ba1d2312322cead4f8c69f",
+  "bytes": 56914,
+  "generatedAt": "2026-03-19T06:19:56.738Z"
+}