[ViewVC] Annotation of: cvs/cvsroot/AnyEvent-MCP/Changes

Revision history for AnyEvent::MCP

        - INCOMPATIBLE CHANGE: due to the added user management, existing
          url tokens have been invalidated.
        - expose IMAP LSUB to inspect subscribed mailboxes, alongside
          subscribe/unsubscribe; return the same format as LIST.
        - remove superseded IMAP OAuth provider and pagination prototypes
          and their obsolete reference tests.
        - note deferred richer IMAP SEARCH and outgoing mail submission
          research in TODO.md.
        - retry reverse connections only for TCP connection refusal and
          unexpected disconnects; report and stop on other TCP errors or
          TLS handshake/verification failures.
        - force scalar context when checking Mail::IMAPTalk results;
          list context truncated LIST responses and could corrupt SEARCH
          results. Test with context-sensitive IMAP mocks.
        - report HTTPS reverse-connection handshake failures rather than
          silently retrying; send credentials only after verified TLS succeeds.
        - omit pointless mailbox permission dimension for mcp-imap mailboxes.
        - clarify expected OAuth redirect error page and account selection.
        - implement mcp-imap OAuth2 authorization-code login with PKCE,
          human-pasted headless browser redirect, HTTPS token exchange,
          refresh-token persistence/rotation and IMAP SASL XOAUTH2.
          Keep interactive credentials outside MCP tools and argv.
        - omit unnecessary shell quotes in mcp-imap providers commands.
        - expand mcp-imap providers with Thunderbird ISPDB domain search,
          provider-hosted HTTPS autoconfig lookup and ISPDB fallback,
          password-based IMAP alternatives and provider setup instructions;
          continue printing optional OAuth configuration without saving it.
        - add per-downstream --hidden to mcp-multibroker, omitting a
          server's tools from normal discovery while retaining explicit
          list-tools, discover-brokers and call-tool access.
        - number the user management test consecutively as t/27_users.t.
        - tidy Perl import grouping, internal comments and source layout
          in the command-line tools and library modules.
        - stop imposing an IMAP account file mode check; access is governed
          by ordinary filesystem permissions.
        - use the permission engine's literal matching convention for exact
          user identities and test positive permission-scope validation.
        - reject invalid browser WebSocket credentials via the documented
          handshake exception interface, producing one specific warning.
        - apply the same handshake rejection handling to Vim WebSocket
          connections, including peer and invalid-token/path warnings.
        - document user-management scopes and URL examples in command help.
        - add scoped, revocable MCP users with HKDF-derived credentials,
          an implicit global default user, and atomic user management;
          list effective user URLs with --print-url[=USER], also accepting
          --print-urls, without binding the advertised listener port.
        - associate HTTP credentials with per-request users, bind user
          identity to persistent permissions and permission continuations,
          and delegate original users through trusted multibrokers.
        - select the effective connect_user (default: default) for reverse
          MCP, private Vim and browser connections, independently of normal
          authenticated HTTP tool calls.
        - treat empty directory paths as "." in mcp-fs list, find, grep and
          VCS cwd, without accepting empty filenames.
        - support opportunistic HTTP/HTTPS and reverse MCP connections on the
          same listener, TLS certificate/key CLI options, and dual URL discovery;
          support verified HTTPS for outgoing reverse connections.
        - treat idle HTTP disconnects as normal EOF while retaining errors
          for clients disconnecting during request headers or bodies.
        - identify failing MCP connections by client name, remote address
          and connection id, including modern per-request client metadata.
        - trace local multibroker prompt starts, outcomes and cancellations
          with elapsed time to diagnose disappearing permission dialogs.
        - use an 8 MiB default MCP message size across JSONL and HTTP
          clients and servers, allowing large base64 tool requests through
          mcp-multibroker; log server transport errors at warn level
          instead of silently closing connections.
        - load AnyEvent::Log at compile time so its format_time call is parsed
          as a function, fixing activity logging on Perl 5.10.

0.71  Fri 30 Oct 2026 18:01:51 CET
        - make multibroker-spawned children ask for permissions through MCP,
          independently of the multibroker's own permission prompt mode.
        - log VCS backend and a bounded, JSON-quoted preview of filenames for
          vcs-diff, vcs-status and vcs-log.
        - load only core modules in t/00_load.t; optional IMAP dependencies
          are tested separately when available.
        - let the fake bubblewrap test use the host temporary directory on
          systems without /tmp (notably Termux).
        - suppress Perl startup locale warnings in sandbox workers when
          the requested C.UTF-8 locale is unavailable.
        - canonicalize temporary test paths to match mcp-fs on systems with
          symlinked temp directories; diagnose failing filesystem assertions.
        - test SSE notification ordering at client delivery rather than
          server enqueue time, avoiding a network scheduling race.
        - diagnose failing multibroker HTTP integration tests with preflight
          responses, RPC results and bounded server startup diagnostics.

0.7   Fri 30 Oct 2026 14:56:18 CET
        - WARNING: mcp-imap is unfinished and has not been tested against a real IMAP server.
        - INCOMPATIBLE CHANGE: rules have changed, old rules will be erased.
        - declare the same license terms as Perl itself in distribution metadata.
        - new mcp servers in this release: mcp-http
        - accept optional dimension default matcher for persistent-rule prompts;
        - clarify that mcp-fs exec has private /tmp by default; shared-tmp
          exposes host /tmp and is not needed for ordinary temporary files or IPC.
        - add mcp-fs vcs-log for Git, SVN, CVS and Mercurial, reusing bounded
          output and dedicated permission actions; SVN log receives network
          and SSH-agent grants alongside CVS operations.
          mcp-webbrowser prefers any JavaScript in the current tab, while the
          independent origin dimension remains scoped to the current origin.
        - log mcp-http requests with their method and a sanitized URL preview;
          identify mcp-http/$VERSION in User-Agent unless overridden by the caller.
          Allow generic key=value context in the shared mcp_log_request formatter.
        - silently treat invalid saved permission-rule files as empty, prompting
          instead of aborting broker startup; subsequent saves replace the old file.
        - add mcp-http for arbitrary HTTP methods with URL-scoped approvals,
          caller-managed cookie jars, bounded bodies and text grep/regex/substitution.
          Disable redirects, retries and proxies; verify HTTPS certificates.
        - derive browser permission origins from reported URLs, not a new
          userscript field; keep older browser clients able to execute with
          origin-scoped permissions.
        - accept compatible browser-protocol minor versions; return empty
          operation discovery for 1.0 clients instead of disconnecting them.
          Direct rule saves no longer perform semantic validation.
        - replace special-case subject, origin and workdir permission scopes with
          named dimensions: metadata-driven prompts, generic match.NAME rule keys,
          and engine-enforced matcher choices. Reject old request and rule fields;
          no conversion or backward-compatible rule loading.
        - preserve selected origin scopes when external permission helpers
          forward persistent decisions through native MCP elicitation.
        - add origin-scoped MCP permission rules, selectable independently of
          code/tab scopes; mcp-webbrowser derives browser origins for
          JavaScript and tab operations, with exact, any-port and any-origin
          choices. Existing rules without origins continue to match all origins.
        - use POSIX::uname instead of nonportable hostname -f for the XPCSE
          browser nickname, consistent with HTTP URL wildcard host selection.
        - make form helper test run via explicit ./ path, avoid early HTTP
          timer races, and test filesystem discovery with optional tools absent.
        - report browser protocol rejections through bounded WebSocket close
          reasons; show abnormal disconnects in the userscript console and toast.
        - document browser wire-protocol minor-version compatibility: accept
          compatible older and newer clients without breaking base functionality.
        - remove the obsolete private stdio permission-result bridge from
          mcp-multibroker; use ordinary form elicitation.
        - add per-tab operation discovery and calls to mcp-webbrowser, with
          per-tab routing, ordinary MCP permissions and browser protocol 1.1;
          the userscript initially advertises no extra operations.
        - make the unsandboxed-warning test tolerate diagnostic output from
          non-GNU utility probes (FreeBSD and BusyBox).
        - add mcp-imap with one named password-authenticated account per instance,
          bounded UID search, MIME reads, explicit mailbox/message mutations,
          UIDPLUS-only targeted expunge, forked worker and MCP permissions.
        - propagate XPCSE save response ETags back to Vim session metadata;
          make stale upload HTTP status an editor error.
        - require GNU sed in worker tool discovery; report missing-Perl diagnostics in tests.
        - xpcse: forward Vim's :write! flag through mcp-vim to browser
          uploads, without changing upload behavior yet.
        - recommend rather than require WebSocket modules: only mcp-vim and
          mcp-webbrowser use them; mcp-vim loads them only for browser clients,
          and tests skip optional WebSocket coverage when unavailable.

0.65  Fri 23 Oct 2026 22:41:32 CEST
        - fix mcp-webbrowser userscript title indicator duplicating prefixes on empty titles.
        - use built scripts in make test PATH, avoiding source shebangs and
          accidentally installed helpers in rule management tests.
        - clarify browser execute code wrapper and reject function/symbol return
          values instead of silently converting them to null.
        - fix many bugs in the testsuite.

0.62  Thu 22 Oct 2026 13:32:52 CEST
        - INCOMPATIBLE API CHANGE: mcp_getoptions now returns a hash reference instead of
          a key/value list.
        - Simple accepts server_name/server_version independently of the local
          instance name, leaving server_info as an unmodified protocol override.
        - query multibroker children in parallel for tool and broker discovery,
          preserving tool order and returning partial results after 15 seconds
          instead of blocking on an unresponsive child.
        - accept a missing trailing slash on HTTP MCP endpoint URLs, working
          around Claude's MCP connector wrongly dropping it from the configured URL,
          thus corrupting it.
        - allow omitted ports in reverse extension URLs, defaulting to port 80.
        - fix MCP client/server version fields serialized as JSON numbers in 0.61.

0.61  Thu 22 Oct 2026 08:57:42 CEST
        - resolve bind hostnames via AnyEvent::Socket instead of Socket::getaddrinfo.
        - honor user-selected file permissions and preserve them across replacements.
        - fix permission test fixture grants.
        - fix activity log timestamp formatting on older perl versions.
        - correct multibroker test tool count (including meta-instructions).
        - fix perl 5.12 syntax errors in mcp-fs and mcp-vim.

0.6  Wed 21 Oct 2026 20:43:20 CEST
        - 34k LOC of pure llm madness. but seems to work. yay.

0.0  Sat 03 Oct 2026 07:29:39 CEST
        - original version, an AnyEvent::HTTP clone.
Revision:	1.49
Committed:	Thu Nov 5 00:05:37 2026 UTC (8 days, 17 hours ago) by root
Branch:	MAIN
Changes since 1.48:	+8 -3 lines
Log Message:	* empty log message *
#	User	Rev	Content
1	root	1.2	Revision history for AnyEvent::MCP
2
3	root	1.49	- INCOMPATIBLE CHANGE: due to the added user management, existing
4			url tokens have been invalidated.
5			- expose IMAP LSUB to inspect subscribed mailboxes, alongside
6			subscribe/unsubscribe; return the same format as LIST.
7			- remove superseded IMAP OAuth provider and pagination prototypes
8			and their obsolete reference tests.
9			- note deferred richer IMAP SEARCH and outgoing mail submission
10			research in TODO.md.
11	root	1.48	- retry reverse connections only for TCP connection refusal and
12			unexpected disconnects; report and stop on other TCP errors or
13			TLS handshake/verification failures.
14			- force scalar context when checking Mail::IMAPTalk results;
15			list context truncated LIST responses and could corrupt SEARCH
16			results. Test with context-sensitive IMAP mocks.
17			- report HTTPS reverse-connection handshake failures rather than
18			silently retrying; send credentials only after verified TLS succeeds.
19			- omit pointless mailbox permission dimension for mcp-imap mailboxes.
20			- clarify expected OAuth redirect error page and account selection.
21			- implement mcp-imap OAuth2 authorization-code login with PKCE,
22			human-pasted headless browser redirect, HTTPS token exchange,
23			refresh-token persistence/rotation and IMAP SASL XOAUTH2.
24			Keep interactive credentials outside MCP tools and argv.
25			- omit unnecessary shell quotes in mcp-imap providers commands.
26			- expand mcp-imap providers with Thunderbird ISPDB domain search,
27			provider-hosted HTTPS autoconfig lookup and ISPDB fallback,
28			password-based IMAP alternatives and provider setup instructions;
29			continue printing optional OAuth configuration without saving it.
30	root	1.47	- add per-downstream --hidden to mcp-multibroker, omitting a
31			server's tools from normal discovery while retaining explicit
32			list-tools, discover-brokers and call-tool access.
33	root	1.46	- number the user management test consecutively as t/27_users.t.
34	root	1.45	- tidy Perl import grouping, internal comments and source layout
35			in the command-line tools and library modules.
36			- stop imposing an IMAP account file mode check; access is governed
37			by ordinary filesystem permissions.
38	root	1.44	- use the permission engine's literal matching convention for exact
39			user identities and test positive permission-scope validation.
40			- reject invalid browser WebSocket credentials via the documented
41			handshake exception interface, producing one specific warning.
42			- apply the same handshake rejection handling to Vim WebSocket
43			connections, including peer and invalid-token/path warnings.
44			- document user-management scopes and URL examples in command help.
45	root	1.43	- add scoped, revocable MCP users with HKDF-derived credentials,
46			an implicit global default user, and atomic user management;
47			list effective user URLs with --print-url[=USER], also accepting
48			--print-urls, without binding the advertised listener port.
49			- associate HTTP credentials with per-request users, bind user
50			identity to persistent permissions and permission continuations,
51			and delegate original users through trusted multibrokers.
52			- select the effective connect_user (default: default) for reverse
53			MCP, private Vim and browser connections, independently of normal
54			authenticated HTTP tool calls.
55	root	1.42	- treat empty directory paths as "." in mcp-fs list, find, grep and
56			VCS cwd, without accepting empty filenames.
57	root	1.41	- support opportunistic HTTP/HTTPS and reverse MCP connections on the
58			same listener, TLS certificate/key CLI options, and dual URL discovery;
59			support verified HTTPS for outgoing reverse connections.
60	root	1.39	- treat idle HTTP disconnects as normal EOF while retaining errors
61			for clients disconnecting during request headers or bodies.
62			- identify failing MCP connections by client name, remote address
63			and connection id, including modern per-request client metadata.
64	root	1.38	- trace local multibroker prompt starts, outcomes and cancellations
65			with elapsed time to diagnose disappearing permission dialogs.
66			- use an 8 MiB default MCP message size across JSONL and HTTP
67			clients and servers, allowing large base64 tool requests through
68			mcp-multibroker; log server transport errors at warn level
69			instead of silently closing connections.
70	root	1.37	- load AnyEvent::Log at compile time so its format_time call is parsed
71			as a function, fixing activity logging on Perl 5.10.
72
73	root	1.36	0.71 Fri 30 Oct 2026 18:01:51 CET
74	root	1.35	- make multibroker-spawned children ask for permissions through MCP,
75			independently of the multibroker's own permission prompt mode.
76	root	1.36	- log VCS backend and a bounded, JSON-quoted preview of filenames for
77			vcs-diff, vcs-status and vcs-log.
78			- load only core modules in t/00_load.t; optional IMAP dependencies
79			are tested separately when available.
80			- let the fake bubblewrap test use the host temporary directory on
81			systems without /tmp (notably Termux).
82			- suppress Perl startup locale warnings in sandbox workers when
83			the requested C.UTF-8 locale is unavailable.
84			- canonicalize temporary test paths to match mcp-fs on systems with
85			symlinked temp directories; diagnose failing filesystem assertions.
86			- test SSE notification ordering at client delivery rather than
87			server enqueue time, avoiding a network scheduling race.
88			- diagnose failing multibroker HTTP integration tests with preflight
89			responses, RPC results and bounded server startup diagnostics.
90	root	1.35
91	root	1.34	0.7 Fri 30 Oct 2026 14:56:18 CET
92			- WARNING: mcp-imap is unfinished and has not been tested against a real IMAP server.
93			- INCOMPATIBLE CHANGE: rules have changed, old rules will be erased.
94			- declare the same license terms as Perl itself in distribution metadata.
95			- new mcp servers in this release: mcp-http
96			- accept optional dimension default matcher for persistent-rule prompts;
97	root	1.33	- clarify that mcp-fs exec has private /tmp by default; shared-tmp
98			exposes host /tmp and is not needed for ordinary temporary files or IPC.
99	root	1.32	- add mcp-fs vcs-log for Git, SVN, CVS and Mercurial, reusing bounded
100			output and dedicated permission actions; SVN log receives network
101			and SSH-agent grants alongside CVS operations.
102	root	1.31	mcp-webbrowser prefers any JavaScript in the current tab, while the
103			independent origin dimension remains scoped to the current origin.
104	root	1.30	- log mcp-http requests with their method and a sanitized URL preview;
105			identify mcp-http/$VERSION in User-Agent unless overridden by the caller.
106	root	1.31	Allow generic key=value context in the shared mcp_log_request formatter.
107	root	1.29	- silently treat invalid saved permission-rule files as empty, prompting
108			instead of aborting broker startup; subsequent saves replace the old file.
109	root	1.30	- add mcp-http for arbitrary HTTP methods with URL-scoped approvals,
110			caller-managed cookie jars, bounded bodies and text grep/regex/substitution.
111			Disable redirects, retries and proxies; verify HTTPS certificates.
112			- derive browser permission origins from reported URLs, not a new
113			userscript field; keep older browser clients able to execute with
114			origin-scoped permissions.
115			- accept compatible browser-protocol minor versions; return empty
116			operation discovery for 1.0 clients instead of disconnecting them.
117	root	1.29	Direct rule saves no longer perform semantic validation.
118	root	1.28	- replace special-case subject, origin and workdir permission scopes with
119			named dimensions: metadata-driven prompts, generic match.NAME rule keys,
120			and engine-enforced matcher choices. Reject old request and rule fields;
121			no conversion or backward-compatible rule loading.
122	root	1.27	- preserve selected origin scopes when external permission helpers
123			forward persistent decisions through native MCP elicitation.
124	root	1.26	- add origin-scoped MCP permission rules, selectable independently of
125	root	1.30	code/tab scopes; mcp-webbrowser derives browser origins for
126	root	1.26	JavaScript and tab operations, with exact, any-port and any-origin
127			choices. Existing rules without origins continue to match all origins.
128	root	1.25	- use POSIX::uname instead of nonportable hostname -f for the XPCSE
129			browser nickname, consistent with HTTP URL wildcard host selection.
130			- make form helper test run via explicit ./ path, avoid early HTTP
131			timer races, and test filesystem discovery with optional tools absent.
132	root	1.23	- report browser protocol rejections through bounded WebSocket close
133			reasons; show abnormal disconnects in the userscript console and toast.
134			- document browser wire-protocol minor-version compatibility: accept
135			compatible older and newer clients without breaking base functionality.
136			- remove the obsolete private stdio permission-result bridge from
137			mcp-multibroker; use ordinary form elicitation.
138	root	1.22	- add per-tab operation discovery and calls to mcp-webbrowser, with
139			per-tab routing, ordinary MCP permissions and browser protocol 1.1;
140			the userscript initially advertises no extra operations.
141			- make the unsandboxed-warning test tolerate diagnostic output from
142			non-GNU utility probes (FreeBSD and BusyBox).
143			- add mcp-imap with one named password-authenticated account per instance,
144			bounded UID search, MIME reads, explicit mailbox/message mutations,
145			UIDPLUS-only targeted expunge, forked worker and MCP permissions.
146	root	1.21	- propagate XPCSE save response ETags back to Vim session metadata;
147			make stale upload HTTP status an editor error.
148			- require GNU sed in worker tool discovery; report missing-Perl diagnostics in tests.
149	root	1.18	- xpcse: forward Vim's :write! flag through mcp-vim to browser
150			uploads, without changing upload behavior yet.
151	root	1.19	- recommend rather than require WebSocket modules: only mcp-vim and
152			mcp-webbrowser use them; mcp-vim loads them only for browser clients,
153			and tests skip optional WebSocket coverage when unavailable.
154	root	1.18
155	root	1.17	0.65 Fri 23 Oct 2026 22:41:32 CEST
156	root	1.14	- fix mcp-webbrowser userscript title indicator duplicating prefixes on empty titles.
157	root	1.17	- use built scripts in make test PATH, avoiding source shebangs and
158			accidentally installed helpers in rule management tests.
159	root	1.15	- clarify browser execute code wrapper and reject function/symbol return
160			values instead of silently converting them to null.
161	root	1.17	- fix many bugs in the testsuite.
162	root	1.13
163	root	1.12	0.62 Thu 22 Oct 2026 13:32:52 CEST
164	root	1.16	- INCOMPATIBLE API CHANGE: mcp_getoptions now returns a hash reference instead of
165			a key/value list.
166	root	1.11	- Simple accepts server_name/server_version independently of the local
167			instance name, leaving server_info as an unmodified protocol override.
168			- query multibroker children in parallel for tool and broker discovery,
169			preserving tool order and returning partial results after 15 seconds
170			instead of blocking on an unresponsive child.
171	root	1.8	- accept a missing trailing slash on HTTP MCP endpoint URLs, working
172	root	1.10	around Claude's MCP connector wrongly dropping it from the configured URL,
173	root	1.18	thus corrupting it.
174	root	1.7	- allow omitted ports in reverse extension URLs, defaulting to port 80.
175	root	1.9	- fix MCP client/server version fields serialized as JSON numbers in 0.61.
176	root	1.7
177	root	1.6	0.61 Thu 22 Oct 2026 08:57:42 CEST
178	root	1.5	- resolve bind hostnames via AnyEvent::Socket instead of Socket::getaddrinfo.
179	root	1.4	- honor user-selected file permissions and preserve them across replacements.
180			- fix permission test fixture grants.
181			- fix activity log timestamp formatting on older perl versions.
182			- correct multibroker test tool count (including meta-instructions).
183			- fix perl 5.12 syntax errors in mcp-fs and mcp-vim.
184
185	root	1.3	0.6 Wed 21 Oct 2026 20:43:20 CEST
186	root	1.2	- 34k LOC of pure llm madness. but seems to work. yay.
187	root	1.1
188			0.0 Sat 03 Oct 2026 07:29:39 CEST
189			- original version, an AnyEvent::HTTP clone.