Skip to content

0.1.2 (15/15): opt-in background mode - #16

Merged
trevoedwards merged 6 commits into
mainfrom
pr/0.1.2-15-background
Nov 1, 2026
Merged

trevoedwards merged 6 commits into
mainfrom
pr/0.1.2-15-background

Conversation

@trevoedwards

Copy link
Copy Markdown
Collaborator

Part 15 of the 0.1.2 stack. Depends on part 14; base: pr/0.1.2-14-file-panels. Merge the preceding PR first. Existing topic commits and AI co-author trailers are preserved; already-merged CI fixes are carried through the stack.

Adds an opt-in background connection mode so MacMCP can work in a target app without deliberately activating it or moving the person's pointer.

  • The person configures mac-mcp --background in the client's relay arguments. Mode defaults off, is fixed before JSON-RPC, survives reconnects, and is visible in instructions, results and doctor. Tools cannot change it; unknown relay arguments fail instead of silently selecting foreground mode.
  • Uses guarded AX actions/value/selection edits and PID-targeted keys only with exact, readable app-local focus and window ownership. Typing verifies the resulting value, preserves rich text for append/insert, checks concurrent changes and preflights Return before submit writes. There is no foreground or pointer fallback.
  • Captures target windows even when covered, with no display-crop fallback. Unsupported or unsafe routes refuse: coordinates/drags, Finder/file panels, secure fields, app/window management, clipboard writes, scripts, Shortcuts and Safari automation. Exposed safe menu leaves can be pressed; menu tracking and dangerous key/menu sequences refuse.
  • Existing app/path/prompt/identity/lease/pause/deadline and audit checks still apply. The mode gives no extra concurrency or permission. Apps may independently activate in response to their own AX/menu implementation; targeted-key delivery alone is not proof of effect.
  • Includes the final review hardening and two integration-fixture fixes: find the floating-panel field across the app and explicitly focus Name before append, avoiding test-order dependence.

Validation: the combined unit run passed 171 server and 846 core tests. The 116-test GUI run had two background-fixture lookup failures; after those fixture fixes, all three background tests passed twice in isolation, checking foreground app/pointer preservation, covered-window capture/OCR and refusals. The earlier 31-task Haiku benchmark is a foreground evaluation, not a background-mode evaluation.

This final head preserves the tested release history and the already-merged CI updates. Its application, test and CI files match the validated release tip; only the benchmark debug-fragment cleanup from part 13 changes the final tree.

PR prepared with Codex. Original implementation co-author trailers are retained.

@trevoedwards
trevoedwards added this pull request to stack #17 November 1, 2026 03:53
@trevoedwards
trevoedwards force-pushed the pr/0.1.2-15-background branch 5 times, most recently from 34dde0a to 6fecf9c Compare November 1, 2026 03:55
Base automatically changed from pr/0.1.2-14-file-panels to main November 1, 2026 03:55
trevoedwards and others added 6 commits October 31, 2026 20:55
Co-Authored-By: GPT-6.1 Sol <noreply@openai.com>
Co-Authored-By: GPT-6.1 Sol <noreply@openai.com>
Co-Authored-By: GPT-6.1 Sol <noreply@openai.com>
Preserve rich text with selected-text edits, recheck concurrent changes,
and preflight Return before any submit write. Check menu identities and
actions independently of key equivalents, and refuse menu tracking,
window/app management and clipboard mutations in background mode.

Reject unsafe focus/activation key sequences and unknown relay arguments.
Add unit coverage, update integration cases without running them, and
align the background-mode documentation with the enforced refusals.

Co-Authored-By: GPT-6.1 Sol <noreply@openai.com>
(cherry picked from commit 229b5e861a7a7068f56386e1a570fe12607f91c1)
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
@trevoedwards
trevoedwards force-pushed the pr/0.1.2-15-background branch from 6fecf9c to e0dc707 Compare November 1, 2026 03:55
@trevoedwards
trevoedwards merged commit 9caf8a8 into main Nov 1, 2026
1 check passed
@trevoedwards
trevoedwards deleted the pr/0.1.2-15-background branch November 1, 2026 03:56
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant