@prmichaelsen/acp-mcp 0.5.1 → 0.7.0

package/CHANGELOG.md

@@ -5,6 +5,72 @@ 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.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
+- **Comprehensive file metadata** in `acp_remote_list_files` tool
+  - Now returns structured JSON with full file information
+  - Includes permissions (mode, string, owner/group/others breakdown)
+  - Includes timestamps (accessed, modified in ISO 8601 format)
+  - Includes ownership (uid, gid)
+  - Includes file type (file, directory, symlink, other)
+  - Includes file size in bytes
+- **`includeHidden` parameter** for `acp_remote_list_files` (default: true)
+  - Control whether hidden files (starting with `.`) are included
+  - Addresses GitHub Issue #2 - incomplete directory listings
+
+### Fixed
+- **CRITICAL**: Fixed GitHub Issue #2 - `acp_remote_list_files` missing hidden files
+  - Root cause: SFTP `readdir()` filters hidden files by default (protocol behavior)
+  - Solution: Hybrid approach using shell `ls` for filenames + SFTP `stat()` for metadata
+  - Now returns ALL files including hidden directories (`.ssh`, `.config`, `.npm`, etc.)
+  - Fallback to SFTP `readdir()` if shell command unavailable
+
+### Changed
+- **BREAKING**: `acp_remote_list_files` output format changed from simple text to structured JSON
+  - **Before**: Newline-separated list of paths
+  - **After**: JSON array of FileEntry objects with comprehensive metadata
+  - **Migration**: Parse JSON response to access file information
+  - **Benefit**: Rich metadata enables better file system operations and decision-making
+
+### Technical Details
+- Added `FileEntry` interface in `src/types/file-entry.ts`
+- Updated `SSHConnectionManager.listFiles()` with hybrid implementation
+- Added helper functions: `parsePermissions()`, `modeToPermissionString()`, `getFileType()`
+- Enhanced logging for file listing operations
+- Maintains backward compatibility via fallback to SFTP
+
 ## [0.5.0] - 2026-02-23
 
 ### Fixed

package/README.md

@@ -56,17 +56,26 @@ const server = await createServer({
 
 ## Available Tools
 
-- **acp_remote_list_files** - List files and directories in a specified path on the remote machine
+- **acp_remote_list_files** - List files and directories with comprehensive metadata
   - `path` (required): The directory path to list files from
   - `recursive` (optional): Whether to list files recursively (default: false)
-  - **Returns**: Absolute paths (e.g., `/home/user/project/file.txt`) that can be used directly with other tools
-  - **Note**: As of v0.5.0, returns absolute paths instead of relative filenames for seamless integration with read/write operations
+  - `includeHidden` (optional): Whether to include hidden files starting with `.` (default: true)
+  - **Returns**: JSON array of file entries with metadata (permissions, timestamps, size, ownership)
+  - **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? }`
+  - **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