@prmichaelsen/acp-mcp 0.6.0 → 0.7.1

package/CHANGELOG.md

@@ -5,6 +5,55 @@ All notable changes to this project will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [0.7.1] - 2026-02-23
+
+### Fixed
+- **Shell environment not loaded**: Commands now properly source shell configuration files (`~/.zshrc`, `~/.bashrc`, `~/.profile`)
+  - Non-interactive SSH shells don't source config files by default
+  - This caused `$PATH` to be incomplete and environment variables to be missing
+  - Commands like `npm`, `node`, `git` would fail with "command not found" if installed via nvm, homebrew, or other user-space package managers
+  - Solution: Wrap all commands with shell config sourcing: `(source ~/.zshrc || source ~/.bashrc || source ~/.profile || true) && command`
+  - Applies to both `execWithTimeout()` and `execStream()` methods
+  - Gracefully handles missing config files (uses `|| true` to prevent errors)
+
+### Technical Details
+- Added `wrapCommandWithShellInit()` private method to SSHConnectionManager
+- Tries to source config files in order: `.zshrc` → `.bashrc` → `.profile`
+- Ignores errors if files don't exist (2>/dev/null and || true)
+- No breaking changes - transparent to users
+- Fixes common issue where user-installed tools aren't in PATH
+
+## [0.7.0] - 2026-02-23
+
+### Added
+- **Progress Streaming** for `acp_remote_execute_command` tool
+  - Real-time output streaming for long-running commands
+  - Uses MCP SDK's native progress notification system (`notifications/progress`)
+  - Graceful fallback to timeout mode for clients without progress support
+  - Rate limiting prevents notification spam (max 10/second, 100ms interval)
+  - Supports commands like `npm run build`, `npm run dev`, `npm test`
+  - Progress notifications include stdout chunks as messages
+  - Automatically resets request timeout on progress (prevents timeout for long operations)
+- **`execStream()` method** in SSHConnectionManager
+  - Returns stdout stream, stderr stream, and exit code promise
+  - Enables real-time processing of command output
+  - Comprehensive logging for stream lifecycle
+  - Error handling for stream failures
+
+### Changed
+- `acp_remote_execute_command` handler now accepts `extra` parameter with `progressToken`
+- Server request handlers pass `extra` to execute_command handler
+- Tool description updated to mention progress streaming support
+- Timeout parameter ignored when progress streaming is active
+
+### Technical Details
+- Requires MCP SDK v1.26.0+ for progress support
+- Progress token accessed via `extra._meta.progressToken`
+- Progress notifications sent via `server.notification()` method
+- Backward compatible - existing clients unaffected
+- No breaking changes to API
+- Streaming mode indicated by `streamed: true` in response
+
 ## [0.6.0] - 2026-02-23
 
 ### Added

package/README.md

@@ -64,11 +64,23 @@ const server = await createServer({
   - **Metadata includes**: name, path, type, size, permissions (mode, string, owner/group/others), owner (uid, gid), timestamps (accessed, modified)
   - **Note**: Uses hybrid approach (shell `ls` + SFTP `stat()`) to get all files including hidden ones with rich metadata
 
-- **acp_remote_execute_command** - Execute a shell command on the remote machine
+- **acp_remote_execute_command** - Execute a shell command on the remote machine with optional progress streaming
   - `command` (required): Shell command to execute
   - `cwd` (optional): Working directory for command execution
-  - `timeout` (optional): Timeout in seconds (default: 30)
-  - Returns: `{ stdout, stderr, exitCode, timedOut }`
+  - `timeout` (optional): Timeout in seconds (default: 30, ignored if progress streaming)
+  - **Returns**: `{ stdout, stderr, exitCode, timedOut, streamed? }`
+  - **Shell Environment** (v0.7.1+): Automatically sources shell configuration files
+    - Sources `~/.zshrc`, `~/.bashrc`, or `~/.profile` before executing commands
+    - Ensures `$PATH` and environment variables are properly loaded
+    - Enables user-installed tools (nvm, homebrew, etc.) to work correctly
+    - Gracefully handles missing config files
+  - **Progress Streaming** (v0.7.0+): Supports real-time output streaming when client provides `progressToken`
+    - Requires MCP SDK v1.26.0+ (server and client)
+    - Client must provide `progressToken` in request `_meta`
+    - Client must handle progress notifications via `onprogress` callback
+    - Graceful fallback to timeout mode if no `progressToken` provided
+    - Rate limited to max 10 notifications/second
+    - Ideal for long-running commands: `npm run build`, `npm test`, `npm run dev`
 
 - **acp_remote_read_file** - Read file contents from the remote machine
   - `path` (required): Absolute path to file