ViewVC Help
View File | Revision Log | Show Annotations | Download File
/cvs/cvsroot/AnyEvent-MCP/Changes
Revision: 1.79
Committed: Sat Nov 7 20:37:01 2026 UTC (8 days, 11 hours ago) by root
Branch: MAIN
Changes since 1.78: +18 -0 lines
Log Message:
*** empty log message ***

File Contents

# User Rev Content
1 root 1.2 Revision history for AnyEvent::MCP
2    
3 root 1.64 0.83 (unreleased)
4 root 1.79 - load Encode::MIME::Header explicitly in the mcp-imap worker; only
5     mcp-imap requires it, not other AnyEvent::MCP components.
6     - decode RFC 2047 encoded subject and address display fields in
7     mcp-imap ENVELOPE summaries; include attachment names, MIME types,
8     sizes and part numbers in read-only previews without extra FETCHes.
9     - make mcp-fs remote subprocess framing byte-only: explicitly UTF-8
10     encode MCP argv and Unicode paths at their source, preserve raw OS
11     executable/env paths and binary stdin, reject non-octet frame fields;
12     add remote and VCS Unicode path/argv regressions.
13     - log idle IMAP keepalive failure details at trace and suppress only
14     IMAPTalk's raw warning for our expected timeout exception.
15     - register installed optional Encode::HanExtra, Encode::JIS2K and
16     Encode::EUCJPASCII charsets for mcp-imap MIME decoding; advertise
17     them as runtime suggestions, not dependencies.
18     - split distribution tests into core cNN_ files run by default and
19     extended eNN_ files skipped without PERL_ANYEVENT_MCP_TESTS=1;
20     add independent core filesystem smoke tests while retaining the full
21     integration and failure-injection suite for development and releases.
22 root 1.78 - include mailbox, destination, operation, batch size, paging position
23     and bounded SEARCH criteria in mcp-imap request logs, without
24     logging message bodies or UID lists.
25     - keep remote filesystem tests valid with long CPAN tester Perl paths:
26     the mock rsh checks the short loader overhead without imposing
27     an artificial 256-byte limit on the executable pathname.
28     - shorten mcp-fs remote bootstrap: embed the launcher byte length with
29     sprintf and append source directly via sysread without extra argv.
30 root 1.77 - raise sort_create/sort_page UID page maximum from 100 to 1000,
31     keeping the default at 100 and leaving message fetching and MOVE
32     batches capped at 100.
33 root 1.76 - enable multibroker-managed idle exit in mcp-http and mcp-ask-user
34     after 300 seconds, and mcp-imap after 3600 seconds (mcp-fs already
35     supported 300 seconds). Retain ask-user continuations; disposable
36     IMAP SORT snapshots are lost on idle exit. Retry declined idle
37     shutdown after the interval.
38 root 1.75 - add worker-local immutable UID SORT (SUBJECT DATE) snapshots for
39     subject-grouped classification: sort_create returns the first 100
40     UIDs, sort_page pages without re-sorting, sort_discard frees the
41     snapshot; one snapshot per worker, invalidated on restart.
42 root 1.74 - expose read-only UID THREAD ORDEREDSUBJECT through mcp-imap:
43     group by base subject with optional SEARCH filter and UID range,
44     retaining the complete nested server order without pagination.
45 root 1.72 - keep mcp-imap connections alive with an idle NOOP (250 seconds by
46     default, configurable via --keepalive, 0 disables); stop pinging
47     on failure, and reconnect on the next tool call without retrying
48     interrupted operations.
49 root 1.69 - allow shell-friendly instance names (ASCII alphanumerics, underscore,
50     hyphen, dot, @ and +), with separate strict managed-user names.
51     - fold small state-file locking and atomic replacement helper into
52     MCP.pm instead of a separate AnyEvent::MCP::File module.
53     - make --ask a shared common option, with per-option exclusion;
54     add --ask none to deny unresolved permissions and decline
55     downstream elicitation without prompting.
56 root 1.71 - document mcp-imap login keys individually in --help and manpage;
57     support tls connect/starttls/none (including explicit unencrypted IMAP)
58     and reset default ports on TLS mode changes.
59     - report LOGINDISABLED with no supported SASL mechanism cleanly on
60     IMAP password login, without obscure Authen::SASL warnings.
61 root 1.70 - add mcp_permissions to Simple: default permission engine, explicit
62     object or explicit undef; apply --ask and automatic rule overrides
63     centrally without dropping application-supplied automatic rules.
64 root 1.68 - give mcp-fs writable private /tmp and /var/tmp (mode 1777) even
65     with world-read; only shared-tmp or world-write exposes host
66     temporary directories. Make world-write formally imply shared-tmp
67     for permission checks; document the private/host lifetime distinction.
68     - add read-only mcp-imap previews for 25 UIDs, with bounded partial
69     MIME decoding, HTML link preservation and grouped IMAP FETCH calls.
70     - allow mcp-imap messages to fetch selected UIDs without SEARCH.
71     - actually truncate bounded IMAP part/raw responses to max_bytes,
72     not just flag them as truncated.
73 root 1.67 - use a 15-second HTTP read-inactivity timeout by default, suspended
74     while processing complete requests; respect explicit handle rtimeout.
75     - load MIME::Base64 in the HTTP server itself for encoded modern
76     Mcp-Name headers, without depending on the HTTP client loading it.
77 root 1.66 - log ordinary HTTP 404 responses at trace rather than warn,
78     including GET /; keep other HTTP rejection warnings.
79 root 1.73 - return 404 to GET / even when / is the MCP POST endpoint; drop
80     the unhelpful connection object address from HTTP rejection logs
81     while retaining the remote address and sanitized URI.
82 root 1.65 - reuse the latest saved per-dimension scope as the next permission
83     rule editor's default where offered, otherwise keep the original
84     conservative choice; native, YAD and terminal forms agree.
85     - handle the common token-only HTTP endpoint in warning logs:
86     redact known tokens without misclassifying unrelated paths.
87     - include bounded, JSON-escaped request paths in rejected HTTP request
88     warnings; omit queries and redact configured and attempted URL tokens.
89 root 1.64 - show captured helper status, stderr and stdout when the permission
90     UI test fails, and report remote file-patch results and file content
91     when the mock remote filesystem test fails (CPAN Testers diagnostics).
92    
93 root 1.63 0.82 Fri 06 Nov 2026 15:53:46 CET
94     - add a first-permission-dialog walkthrough to Intro.pod, explaining
95     one-time versus persistent grants, rule scopes and exec stdin risks;
96     correct its description of logical workdir IDs.
97 root 1.62 - add common repeatable -s/--set KEY=VALUE process-local overrides
98     for trusted instance configuration, after program/instance defaults.
99     - key remote mcp-fs host permissions by --host alone, independent of
100     --rsh; add independent local/remote host scopes (this host by
101     default, or all hosts), retaining old unscoped saved rules.
102     Workdir scopes remain plain paths, independent of host.
103     - omit single-choice permission scope selectors from native, YAD and
104     terminal rule dialogs, automatically retaining the sole match in
105     saved rules without broadening their applicability.
106 root 1.60 - log rejected HTTP requests (status 400 and above) with method,
107     status and peer information, without leaking URL tokens; demote
108 root 1.61 ordinary connection/TLS errors to trace.
109 root 1.62 - do not warn on routine GET / requests; keep the normal 404
110     response without exposing a server-identification page.
111     - preserve mcp-vim subprocess stderr when its JSONL initialization
112     fails, instead of hiding the failure behind EOF and SIGPIPE.
113 root 1.57 - bootstrap remote mcp-fs over a short Perl command, streaming the
114     launcher source over stdin. Avoid rsh command length limits and
115     preserve worker input across exec by using exact sysread.
116 root 1.58 - format mcp-fs sandbox grants, tools, trusted configuration keys
117     and permission action classes as individually searchable POD items.
118 root 1.62 - give the mock remote filesystem test its running Perl interpreter
119     explicitly, rather than assuming it is in a fixed Unix PATH.
120     - avoid locale-dependent TCP error strings in reverse-connection tests,
121     and skip mcp-imap provider CLI tests when optional fork modules
122     are unavailable while retaining standalone provider parser tests.
123 root 1.57
124 root 1.56 0.81 Thu 05 Nov 2026 04:51:59 CET
125 root 1.55 - keep OAuth2 tests working without optional Mail::IMAPTalk,
126     IO::Socket::SSL or Authen::SASL; skip only worker-specific checks.
127     - support optional `mount-try.SUFFIX = ro:/path` or `rw:/path` in
128     mcp-fs configuration. Pass these directly as bubblewrap
129     --ro-bind-try/--bind-try for each invocation, without startup path
130     checks, locally and remotely; required mount.* entries are unchanged.
131     - support one remote host per mcp-fs instance with -h/--host and
132     -e/--rsh; resolve remote workdirs and available tools in a single
133     startup probe, then execute existing workers through a binary-framed
134     remote Perl launcher without installing any MCP modules remotely.
135 root 1.56 - use logical absolute pathnames (without resolving symlinks) as compact
136     workdir IDs across hosts; qualify remote permission scopes independently.
137     Named profiles remain shared between instances. Report cached remote
138     VCS markers and remote umask.
139 root 1.55 - reserve -h for application-specific options; --help remains common.
140     - test remote workers, external GNU utilities, permission isolation,
141     shell argument quoting and startup probing using a mock remote shell
142     and bubblewrap, including unsandboxed/auto behavior. Verify matching
143 root 1.56 workdir IDs for identical logical paths across local and remote
144 root 1.55 instances.
145     - make mock remote-agent tests independent of a local SSH_AUTH_SOCK
146     inherited from the test runner (including CPAN Testers).
147     - document --eager when starting mcp-webbrowser through multibroker;
148     defer possible downstream preferences for --eager and --hidden.
149    
150 root 1.53 0.8 Thu 05 Nov 2026 01:52:48 CET
151 root 1.49 - INCOMPATIBLE CHANGE: due to the added user management, existing
152     url tokens have been invalidated.
153 root 1.54 - limit distribution permission normalization to its staging
154     directory, and supply proper CPAN author and abstract metadata.
155 root 1.52 - give shared command-line switches their own reference in
156     Server::Simple; use individually indexed POD items for executable
157     options and application-specific shared-option behavior.
158 root 1.51 - refresh the introductory guide and mcp-imap/mcp-http manuals
159     with first-use workflows, OAuth2 setup, mailbox/search examples
160     and reverse-TLS troubleshooting; correct stale retry documentation.
161 root 1.50 - extend mcp-imap SEARCH filters with recursive AND/OR/NOT, header,
162     text/body, date, size and flag criteria; use explicitly quoted
163     IMAP arguments and bounded filter complexity.
164     - capture deliberately triggered connection errors in test assertions,
165     avoiding noisy successful test runs.
166 root 1.49 - expose IMAP LSUB to inspect subscribed mailboxes, alongside
167     subscribe/unsubscribe; return the same format as LIST.
168     - remove superseded IMAP OAuth provider and pagination prototypes
169     and their obsolete reference tests.
170 root 1.51 - defer outgoing mail submission research (mcp-smtp or mcp-imap)
171     in TODO.md.
172 root 1.48 - retry reverse connections only for TCP connection refusal and
173     unexpected disconnects; report and stop on other TCP errors or
174     TLS handshake/verification failures.
175     - force scalar context when checking Mail::IMAPTalk results;
176     list context truncated LIST responses and could corrupt SEARCH
177     results. Test with context-sensitive IMAP mocks.
178     - report HTTPS reverse-connection handshake failures rather than
179     silently retrying; send credentials only after verified TLS succeeds.
180     - omit pointless mailbox permission dimension for mcp-imap mailboxes.
181     - clarify expected OAuth redirect error page and account selection.
182     - implement mcp-imap OAuth2 authorization-code login with PKCE,
183     human-pasted headless browser redirect, HTTPS token exchange,
184     refresh-token persistence/rotation and IMAP SASL XOAUTH2.
185     Keep interactive credentials outside MCP tools and argv.
186     - omit unnecessary shell quotes in mcp-imap providers commands.
187     - expand mcp-imap providers with Thunderbird ISPDB domain search,
188     provider-hosted HTTPS autoconfig lookup and ISPDB fallback,
189     password-based IMAP alternatives and provider setup instructions;
190     continue printing optional OAuth configuration without saving it.
191 root 1.47 - add per-downstream --hidden to mcp-multibroker, omitting a
192     server's tools from normal discovery while retaining explicit
193     list-tools, discover-brokers and call-tool access.
194 root 1.46 - number the user management test consecutively as t/27_users.t.
195 root 1.45 - tidy Perl import grouping, internal comments and source layout
196     in the command-line tools and library modules.
197     - stop imposing an IMAP account file mode check; access is governed
198     by ordinary filesystem permissions.
199 root 1.44 - use the permission engine's literal matching convention for exact
200     user identities and test positive permission-scope validation.
201     - reject invalid browser WebSocket credentials via the documented
202     handshake exception interface, producing one specific warning.
203     - apply the same handshake rejection handling to Vim WebSocket
204     connections, including peer and invalid-token/path warnings.
205     - document user-management scopes and URL examples in command help.
206 root 1.43 - add scoped, revocable MCP users with HKDF-derived credentials,
207     an implicit global default user, and atomic user management;
208     list effective user URLs with --print-url[=USER], also accepting
209     --print-urls, without binding the advertised listener port.
210     - associate HTTP credentials with per-request users, bind user
211     identity to persistent permissions and permission continuations,
212     and delegate original users through trusted multibrokers.
213     - select the effective connect_user (default: default) for reverse
214     MCP, private Vim and browser connections, independently of normal
215     authenticated HTTP tool calls.
216 root 1.42 - treat empty directory paths as "." in mcp-fs list, find, grep and
217     VCS cwd, without accepting empty filenames.
218 root 1.41 - support opportunistic HTTP/HTTPS and reverse MCP connections on the
219     same listener, TLS certificate/key CLI options, and dual URL discovery;
220     support verified HTTPS for outgoing reverse connections.
221 root 1.39 - treat idle HTTP disconnects as normal EOF while retaining errors
222     for clients disconnecting during request headers or bodies.
223     - identify failing MCP connections by client name, remote address
224     and connection id, including modern per-request client metadata.
225 root 1.38 - trace local multibroker prompt starts, outcomes and cancellations
226     with elapsed time to diagnose disappearing permission dialogs.
227     - use an 8 MiB default MCP message size across JSONL and HTTP
228     clients and servers, allowing large base64 tool requests through
229     mcp-multibroker; log server transport errors at warn level
230     instead of silently closing connections.
231 root 1.37 - load AnyEvent::Log at compile time so its format_time call is parsed
232     as a function, fixing activity logging on Perl 5.10.
233    
234 root 1.36 0.71 Fri 30 Oct 2026 18:01:51 CET
235 root 1.35 - make multibroker-spawned children ask for permissions through MCP,
236     independently of the multibroker's own permission prompt mode.
237 root 1.36 - log VCS backend and a bounded, JSON-quoted preview of filenames for
238     vcs-diff, vcs-status and vcs-log.
239     - load only core modules in t/00_load.t; optional IMAP dependencies
240     are tested separately when available.
241     - let the fake bubblewrap test use the host temporary directory on
242     systems without /tmp (notably Termux).
243     - suppress Perl startup locale warnings in sandbox workers when
244     the requested C.UTF-8 locale is unavailable.
245     - canonicalize temporary test paths to match mcp-fs on systems with
246     symlinked temp directories; diagnose failing filesystem assertions.
247     - test SSE notification ordering at client delivery rather than
248     server enqueue time, avoiding a network scheduling race.
249     - diagnose failing multibroker HTTP integration tests with preflight
250     responses, RPC results and bounded server startup diagnostics.
251 root 1.35
252 root 1.34 0.7 Fri 30 Oct 2026 14:56:18 CET
253     - WARNING: mcp-imap is unfinished and has not been tested against a real IMAP server.
254     - INCOMPATIBLE CHANGE: rules have changed, old rules will be erased.
255     - declare the same license terms as Perl itself in distribution metadata.
256     - new mcp servers in this release: mcp-http
257     - accept optional dimension default matcher for persistent-rule prompts;
258 root 1.33 - clarify that mcp-fs exec has private /tmp by default; shared-tmp
259     exposes host /tmp and is not needed for ordinary temporary files or IPC.
260 root 1.32 - add mcp-fs vcs-log for Git, SVN, CVS and Mercurial, reusing bounded
261     output and dedicated permission actions; SVN log receives network
262     and SSH-agent grants alongside CVS operations.
263 root 1.31 mcp-webbrowser prefers any JavaScript in the current tab, while the
264     independent origin dimension remains scoped to the current origin.
265 root 1.30 - log mcp-http requests with their method and a sanitized URL preview;
266     identify mcp-http/$VERSION in User-Agent unless overridden by the caller.
267 root 1.31 Allow generic key=value context in the shared mcp_log_request formatter.
268 root 1.29 - silently treat invalid saved permission-rule files as empty, prompting
269     instead of aborting broker startup; subsequent saves replace the old file.
270 root 1.30 - add mcp-http for arbitrary HTTP methods with URL-scoped approvals,
271     caller-managed cookie jars, bounded bodies and text grep/regex/substitution.
272     Disable redirects, retries and proxies; verify HTTPS certificates.
273     - derive browser permission origins from reported URLs, not a new
274     userscript field; keep older browser clients able to execute with
275     origin-scoped permissions.
276     - accept compatible browser-protocol minor versions; return empty
277     operation discovery for 1.0 clients instead of disconnecting them.
278 root 1.29 Direct rule saves no longer perform semantic validation.
279 root 1.28 - replace special-case subject, origin and workdir permission scopes with
280     named dimensions: metadata-driven prompts, generic match.NAME rule keys,
281     and engine-enforced matcher choices. Reject old request and rule fields;
282     no conversion or backward-compatible rule loading.
283 root 1.27 - preserve selected origin scopes when external permission helpers
284     forward persistent decisions through native MCP elicitation.
285 root 1.26 - add origin-scoped MCP permission rules, selectable independently of
286 root 1.30 code/tab scopes; mcp-webbrowser derives browser origins for
287 root 1.26 JavaScript and tab operations, with exact, any-port and any-origin
288     choices. Existing rules without origins continue to match all origins.
289 root 1.25 - use POSIX::uname instead of nonportable hostname -f for the XPCSE
290     browser nickname, consistent with HTTP URL wildcard host selection.
291     - make form helper test run via explicit ./ path, avoid early HTTP
292     timer races, and test filesystem discovery with optional tools absent.
293 root 1.23 - report browser protocol rejections through bounded WebSocket close
294     reasons; show abnormal disconnects in the userscript console and toast.
295     - document browser wire-protocol minor-version compatibility: accept
296     compatible older and newer clients without breaking base functionality.
297     - remove the obsolete private stdio permission-result bridge from
298     mcp-multibroker; use ordinary form elicitation.
299 root 1.22 - add per-tab operation discovery and calls to mcp-webbrowser, with
300     per-tab routing, ordinary MCP permissions and browser protocol 1.1;
301     the userscript initially advertises no extra operations.
302     - make the unsandboxed-warning test tolerate diagnostic output from
303     non-GNU utility probes (FreeBSD and BusyBox).
304     - add mcp-imap with one named password-authenticated account per instance,
305     bounded UID search, MIME reads, explicit mailbox/message mutations,
306     UIDPLUS-only targeted expunge, forked worker and MCP permissions.
307 root 1.21 - propagate XPCSE save response ETags back to Vim session metadata;
308     make stale upload HTTP status an editor error.
309     - require GNU sed in worker tool discovery; report missing-Perl diagnostics in tests.
310 root 1.18 - xpcse: forward Vim's :write! flag through mcp-vim to browser
311     uploads, without changing upload behavior yet.
312 root 1.19 - recommend rather than require WebSocket modules: only mcp-vim and
313     mcp-webbrowser use them; mcp-vim loads them only for browser clients,
314     and tests skip optional WebSocket coverage when unavailable.
315 root 1.18
316 root 1.17 0.65 Fri 23 Oct 2026 22:41:32 CEST
317 root 1.14 - fix mcp-webbrowser userscript title indicator duplicating prefixes on empty titles.
318 root 1.17 - use built scripts in make test PATH, avoiding source shebangs and
319     accidentally installed helpers in rule management tests.
320 root 1.15 - clarify browser execute code wrapper and reject function/symbol return
321     values instead of silently converting them to null.
322 root 1.17 - fix many bugs in the testsuite.
323 root 1.13
324 root 1.12 0.62 Thu 22 Oct 2026 13:32:52 CEST
325 root 1.16 - INCOMPATIBLE API CHANGE: mcp_getoptions now returns a hash reference instead of
326     a key/value list.
327 root 1.11 - Simple accepts server_name/server_version independently of the local
328     instance name, leaving server_info as an unmodified protocol override.
329     - query multibroker children in parallel for tool and broker discovery,
330     preserving tool order and returning partial results after 15 seconds
331     instead of blocking on an unresponsive child.
332 root 1.8 - accept a missing trailing slash on HTTP MCP endpoint URLs, working
333 root 1.10 around Claude's MCP connector wrongly dropping it from the configured URL,
334 root 1.18 thus corrupting it.
335 root 1.7 - allow omitted ports in reverse extension URLs, defaulting to port 80.
336 root 1.9 - fix MCP client/server version fields serialized as JSON numbers in 0.61.
337 root 1.7
338 root 1.6 0.61 Thu 22 Oct 2026 08:57:42 CEST
339 root 1.5 - resolve bind hostnames via AnyEvent::Socket instead of Socket::getaddrinfo.
340 root 1.4 - honor user-selected file permissions and preserve them across replacements.
341     - fix permission test fixture grants.
342     - fix activity log timestamp formatting on older perl versions.
343     - correct multibroker test tool count (including meta-instructions).
344     - fix perl 5.12 syntax errors in mcp-fs and mcp-vim.
345    
346 root 1.3 0.6 Wed 21 Oct 2026 20:43:20 CEST
347 root 1.2 - 34k LOC of pure llm madness. but seems to work. yay.
348 root 1.1
349     0.0 Sat 03 Oct 2026 07:29:39 CEST
350     - original version, an AnyEvent::HTTP clone.