[macos][openworlds] Add native supervisor bridge to the OpenWorlds shell

[100yenadmin]

Summary

Add a native supervisor bridge so OpenWorlds can become the visible app shell
without reintroducing the old SwiftUI launcher as the product UI.

Architecture

Expose a small WKWebView bridge:

window.ClawDnDNative.request(type, payload)

Supported request types:

• appStatus
• dependencyStatus
• providerStatuses
• startViewer
• stopViewer
• startProviderSession
• stopProvider
• diagnostics
• copyDiagnostics
• openFallbackDashboard

Native replies:

{ "ok": true, "requestId": "uuid", "type": "appStatus", "payload": {} }

Errors:

{ "ok": false, "requestId": "uuid", "type": "startProviderSession", "error": "message" }

Boundaries

• The bridge controls processes and app prefs only.
• It must not write campaign state directly.
• Provider launches still use existing adapter contracts and player-facade move
  paths.
• If opened in Safari, OpenWorlds must detect the missing bridge and mark native
  controls unavailable.

Acceptance Criteria

• OpenWorlds can read native app status.
• OpenWorlds can read provider status.
• OpenWorlds can start/stop viewer/provider sessions through Swift.
• OpenWorlds can copy diagnostics.
• Missing bridge shows Unavailable, not fake controls.

Validation

swift build --package-path macos/ClawDnDApp
./script/build_and_run.sh --verify
python3 -m unittest viewer.tests.test_openworlds_static -q
git diff --check

Original-Agent Handoff

Inspect first:

• macos/ClawDnDApp/Sources/ClawDnDApp/Views/WebView.swift
• macos/ClawDnDApp/Sources/ClawDnDApp/Services/AppProcessService.swift
• macos/ClawDnDApp/Sources/ClawDnDApp/Services/ProviderAdapters.swift
• viewer/openworlds/app.jsx
• viewer/openworlds/screen-settings.jsx

[coderabbitai]

⚠️ Possible Duplicate Issue(s)

• [macos][openworlds] Native app: OpenWorlds shell with Swift supervisor bridge #82

🔗 Related PRs

#101 - feat(macos): surface provider diagnostics [merged]
#126 - feat(macos): open OpenWorlds play surface [merged]

---

📝 Issue Planner

_{Check the box below or use the @coderabbitai plan command to generate an implementation plan and prompts that you can use with your favorite coding assistant.}

• Create Plan

---

🧪 Issue enrichment is currently in open beta.

You can configure auto-planning by selecting labels in the issue_enrichment configuration.

To disable automatic issue enrichment, add the following to your .coderabbit.yaml:

issue_enrichment:
  auto_enrich:
    enabled: false

💬 Have feedback or questions? Drop into our discord!

[100yenadmin]

Delivered — native supervisor bridge ships: window.ClawDnDNative.request(type,payload) (native-bridge.js:3, verified) with absent-bridge guards.